home *** CD-ROM | disk | FTP | other *** search
/ USA Bestseller / USA BESTSELLER Vol 1-95 (Hepp-Computer)(1995).iso / e004 / 4dos.doc < prev    next >
Text File  |  1994-10-12  |  221KB  |  4,450 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                           44
  9.                          44
  10.                         44      DDDDDDD        OOOOO        SSSSSS
  11.                        44       DDDDDDDD      OOOOOOO      SSSSSSSS
  12.                       44  44    DD     DD    OO     OO    SS
  13.                      44   44    DD     DD    OO     OO    SS
  14.                     44    44    DD     DD    OO     OO     SSSSSS
  15.                    444444444    DD     DD    OO     OO      SSSSSS
  16.                     44444444    DD     DD    OO     OO           SS
  17.                           44    DD     DD    OO     OO           SS
  18.                           44    DDDDDDDD      OOOOOOO     SSSSSSSS
  19.                           44    DDDDDDD        OOOOO       SSSSSS
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                       Version 5.5
  27.  
  28.  
  29.  
  30.  
  31.                           Introduction and Installation Guide
  32.  
  33.  
  34.  
  35.  
  36.                                       Developed By
  37.                                 Rex Conn and Tom Rawson
  38.  
  39.                                     Documentation By
  40.                        Hardin Brothers, Tom Rawson, and Rex Conn
  41.  
  42.  
  43.  
  44.                                       Published By
  45.  
  46.                                     JP Software Inc.
  47.                                      P.O. Box 1470
  48.                                 East Arlington, MA 02174
  49.                                          U.S.A.
  50.  
  51.                                      (617) 646-3975
  52.                                    fax (617) 646-0904
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                   ACKNOWLEDGMENTS
  59.  
  60.  
  61.              We couldn't produce a product like 4DOS without the dedication
  62.              and quality work of many people.  Our thanks to:
  63.  
  64.                   JP Software Staff:  Mike Bessy, Bobby Kelley, Ellen
  65.                   Stone, Marcella Turner, Misty White.
  66.  
  67.                   Online Support:  Brian Miller and Tess Heder of Channel 1
  68.                   BBS; Don Watkins of CompuServe's IBMNET.
  69.  
  70.                   Beta Test Support:  David Moskowitz and the sysops of
  71.                   CompuServe's CONSULT forum.
  72.  
  73.                   Beta Testers:  We can't list all of our beta testers
  74.                   here!  A special thanks to all of you who helped make
  75.                   4DOS, 4OS2, and 4DOS/NT elegant, reliable, and friendly.
  76.  
  77.              The following tools are used in creating and maintaining 4DOS:
  78.  
  79.                   Compilers:       Microsoft C, Microsoft Macro Assembler,
  80.                                    Borland Turbo Pascal
  81.                   Libraries:       Spontaneous Assembly (Base Two
  82.                                    Development), Turbo Professional (Turbo
  83.                                    Power Software)
  84.                   Editors:         Edix (Emerging Technology), Brief
  85.                                    (Solution Systems)
  86.                   Debuggers:       Periscope (The Periscope Company), Soft-
  87.                                    ICE (Nu-Mega Technologies)
  88.                   Version Control: PVCS (Sage Software)
  89.                   Documentation:   Microsoft Word for Windows with Adobe
  90.                                    Type Manager
  91.  
  92.  
  93.              Copyright 1993, 1994, JP Software Inc., All Rights Reserved.
  94.              4DOS is a registered trademark and 4OS2, JP Software, and the
  95.              JP Software logo and product logos are trademarks of JP
  96.              Software Inc.  Other product and company names are trademarks
  97.              of their respective owners.
  98.  
  99.                                                                        9-94
  100.                                                                    CONTENTS
  101.         -------------------------------------------------------------------
  102.  
  103.  
  104.  
  105.         CONTENTS
  106.  
  107.  
  108.         Introduction...............................................1
  109.             How to Use This Manual.................................2
  110.             Customer Service and Technical Support.................3
  111.  
  112.         Chapter 1 / Installation...................................4
  113.             Preparing for Installation Under DOS...................4
  114.             Preparing for Installation Under OS/2..................5
  115.             Automated Installation.................................6
  116.             Manual Installation....................................7
  117.             Uninstalling 4DOS......................................8
  118.  
  119.         Chapter 2 / Configuration.................................10
  120.             Configuration Files...................................10
  121.             Setting Up CONFIG.SYS.................................11
  122.                 4DOS and Multiple-Configuration Utilities.........14
  123.                 4DOS and DOS 2....................................14
  124.             Startup Options for Secondary Shells..................15
  125.             Using AUTOEXEC.BAT, 4START, and 4EXIT.................16
  126.             COMSPEC and the COMSPEC Path..........................17
  127.             4DOS Swapping Methods................................ 18
  128.             4DOS Help.............................................19
  129.                 Configuring the Help System.......................21
  130.  
  131.         Chapter 3 / 4DOS and Your Hardware and Software...........23
  132.             The CPU...............................................23
  133.             Memory................................................24
  134.                 Upper Memory Blocks (UMBs)........................27
  135.             Video.................................................29
  136.             Hard Drives and Floppy Disks..........................31
  137.             4DOS and DOS..........................................32
  138.                 Menus and SET Commands in CONFIG.SYS..............32
  139.                 Novell DOS / DR DOS...............................33
  140.             Using 4DOS with Task Switchers and Multitaskers.......34
  141.                 Creating a 4DOS Window............................35
  142.                 Parameters for 4DOS Windows.......................35
  143.                 Multitasking and KEYSTACK.........................37
  144.                 Multitasking and Disk Swapping....................37
  145.                 4DOS and Microsoft Windows........................37
  146.             Using 4DOS on a Network...............................39
  147.                 4DOS and Novell Netware...........................40
  148.  
  149.         Chapter 4 / Using 4DOS Under OS/2.........................42
  150.             OS/2 Version 1.x......................................43
  151.             OS/2 Version 2.x......................................43
  152.                 Settings for DOS Sessions.........................44
  153.                 Configuring DOS Sessions for 4DOS.................45
  154.  
  155.  
  156.         -------------------------------------------------------------------
  157.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / i
  158.                                                                    CONTENTS
  159.         -------------------------------------------------------------------
  160.  
  161.  
  162.                 4DOS.INI..........................................47
  163.                 AUTOEXEC.BAT, 4START, and 4EXIT...................48
  164.             Configuring 4DOS for Dual Boot and Boot Manager.......49
  165.                 CONFIG.SYS........................................50
  166.                 AUTOEXEC.BAT......................................50
  167.                 4DOS.INI, 4START, and 4EXIT.......................51
  168.  
  169.         Appendix A / Solving Software Compatibility Problems......53
  170.             Path Length...........................................54
  171.             Environment Size......................................55
  172.             Testing for Interactions..............................55
  173.             Memory Allocation Conflicts...........................57
  174.                 Memory Allocation and Microsoft Windows...........58
  175.             Advanced Configuration Options........................59
  176.  
  177.         Appendix B / Technical Information........................61
  178.             Detecting 4DOS........................................61
  179.             Placing Keystrokes Into the Keystack..................62
  180.             Writing Installable Commands..........................63
  181.             Using DESCRIPT.ION....................................64
  182.             Interrupt 2E..........................................65
  183.  
  184.         Index.....................................................68
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.         -------------------------------------------------------------------
  215.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / ii
  216.                                                                INTRODUCTION
  217.         -------------------------------------------------------------------
  218.  
  219.  
  220.  
  221.         INTRODUCTION
  222.  
  223.  
  224.         Welcome, and thanks for purchasing 4DOS!
  225.  
  226.         We started developing 4DOS when we realized that our computers
  227.         could be a lot more powerful and a lot more helpful than they were.
  228.         Whether you are a computer novice or an experienced power user, we
  229.         think that 4DOS will help you get the most out of your IBM PC or
  230.         compatible computer.
  231.  
  232.         Technically, 4DOS is a command interpreter or "DOS Shell."  That
  233.         means that it reacts to the commands you type at the C:\> prompt.
  234.         We've designed 4DOS so that you don't have to change your computing
  235.         habits or unlearn anything to use it.  If you know how to display a
  236.         directory, copy a file, or start an application program, you
  237.         already know how to use 4DOS.  4DOS understands all of the commands
  238.         you know and adds to them.  Its purpose is to make DOS friendlier,
  239.         easier to use, and much more powerful and versatile, without
  240.         requiring you to use or learn a new program, a new set of commands,
  241.         or a new style of work.
  242.  
  243.         You can use 4DOS with all versions of MS-DOS and PC-DOS from 2.0
  244.         through 6.2 and above.  You can also use it with all versions of
  245.         Novell DOS and DR DOS (an older name for the same product) from 3.4
  246.         through 7.0 and above, and in DOS sessions started under OS/2 1.x
  247.         or 2.x and Windows 3.0 or 3.1.
  248.  
  249.         Once you have 4DOS installed, you can learn its new features at
  250.         your own pace.  It has more than 50 new commands and hundreds of
  251.         enhanced features, but you don't have to learn them all at once.
  252.         Relax, enjoy 4DOS's power, and browse through the manual
  253.         occasionally.  Press the F1 key whenever you need help.  4DOS will
  254.         soon become an essential part of your computer, and you'll wonder
  255.         how you ever got along without it.
  256.  
  257.         If you want to take 4DOS for a spin without performing a complete
  258.         installation, see the separate Guided Tour documentation.
  259.  
  260.         We are constantly working to improve 4DOS.  If you have suggestions
  261.         for features or commands that you think we should include in the
  262.         next version, or any other way we could improve our product, please
  263.         let us know.  Many of the improvements in this version of 4DOS were
  264.         suggested by our users, and while we can't promise to include every
  265.         suggested feature, we really do appreciate and consider your
  266.         comments.
  267.  
  268.         If you use OS/2 or Windows NT, JP Software offers 4OS2, a
  269.         replacement for the OS/2 command processor, and 4DOS for Windows
  270.  
  271.  
  272.         -------------------------------------------------------------------
  273.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 1
  274.                                                                INTRODUCTION
  275.         -------------------------------------------------------------------
  276.  
  277.  
  278.         NT, which is a replacement for the Windows NT command processor.
  279.         These products provide most of the same commands and features
  280.         available in 4DOS, plus several additional commands and new
  281.         features for OS/2 and Windows NT.  You can use these products to
  282.         maintain a common working environment and run the same batch files
  283.         under DOS, OS/2, and Windows NT.  4OS2 and 4DOS for Windows NT are
  284.         available at a discounted price for 4DOS users.  Contact JP
  285.         Software or your dealer for more information.
  286.  
  287.  
  288.         How to Use This Manual
  289.  
  290.              This manual is only one part of the documentation that you
  291.              will need for 4DOS.  It introduces the product and will help
  292.              you install 4DOS correctly on your computer.  It will also
  293.              help you understand some of the terms and concepts that you
  294.              will need to know to get the most from 4DOS, and give you
  295.              specific information on using 4DOS in your particular
  296.              environment (for example under DOS, Windows, or OS/2).
  297.  
  298.              The second part of our documentation is the separate Reference
  299.              Manual.  It contains complete information about the commands
  300.              and features of 4DOS, plus its sister programs, 4OS2 and 4DOS
  301.              for Windows NT.
  302.  
  303.              You should start with this introductory manual whether you are
  304.              new to 4DOS or you are upgrading from a previous version.
  305.              Once you have successfully installed 4DOS, you can move back
  306.              and forth between this manual and the Reference Manual.
  307.  
  308.              For the sake of clarity, we have chosen not to indicate each
  309.              of the hundreds of places in this manual where you can refer
  310.              to the Reference Manual for additional information.  If you
  311.              see a reference here to a 4DOS command, the initialization
  312.              file 4DOS.INI, or any 4DOS feature, you can be sure that
  313.              detailed information on that topic is available in the
  314.              Reference Manual.  In particular, this manual often refers to
  315.              directives in 4DOS.INI, which are covered in detail in Chapter
  316.              5 of the Reference Manual.
  317.  
  318.              4DOS also includes complete online help for all 4DOS and
  319.              standard DOS commands.  The online help provides much of the
  320.              same information that is available in the Reference Manual,
  321.              but in an electronic form which you can access quickly.  See
  322.              page 19 for more details on using the online help.
  323.  
  324.              Files distributed with 4DOS cover important additional
  325.              information beyond what's included in the manuals.  README.DOC
  326.              contains general notes, highlights of the latest release, and
  327.              brief installation instructions for those upgrading from a
  328.  
  329.  
  330.         -------------------------------------------------------------------
  331.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 2
  332.                                                                INTRODUCTION
  333.         -------------------------------------------------------------------
  334.  
  335.  
  336.              downloaded copy.  MANMOD.DOC covers changes or corrections in
  337.              the manuals, if any, and UPDATxxx.DOC contains detailed
  338.              information for users with older versions on what has changed
  339.              in the latest release ("xxx" is the version number).
  340.              APPNOTES.DOC contains application notes for a variety of other
  341.              software packages to help you use those packages with 4DOS.
  342.  
  343.              You will likely find some parts of the documentation too
  344.              simple or too technical for your tastes.  If so, feel free to
  345.              skip to the next part of the manual that is more to your
  346.              liking.  You can use almost every feature of 4DOS without
  347.              having to worry about other features or commands.
  348.  
  349.              As you read the documentation, you will occasionally see an
  350.              exclamation point [!] next to a paragraph.  The exclamation
  351.              point means that that paragraph contains a caution or warning
  352.              you should observe when using the feature it discusses.
  353.  
  354.              You will also see the symbol ## next to certain paragraphs.
  355.              This indicates an in-depth discussion or a more advanced topic
  356.              which you can skip if you wish to stick with the basics.  Come
  357.              back to this topic later for more details, or if you're having
  358.              trouble with the particular issue it discusses.  If you see
  359.              the ## next to a section heading, it means the entire section
  360.              contains such information.
  361.  
  362.              You may find the information in such marked sections useful
  363.              even if you're relatively new to computers or to our products.
  364.              However, you can also skip the marked section and still
  365.              understand and use the basic topic of the larger section
  366.              you're reading.
  367.  
  368.  
  369.         Customer Service and Technical Support
  370.  
  371.              Technical support for 4DOS is available via public electronic
  372.              support conferences, private electronic mail, telephone, fax,
  373.              and mail.  For complete details, including a listing of
  374.              electronic support conferences, see your Reference Manual.
  375.  
  376.              Customer service is always available through the telephone and
  377.              fax numbers listed on the title page of this manual.  See your
  378.              Reference manual for electronic mail addresses for our Sales
  379.              and Customer Service departments.
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.         -------------------------------------------------------------------
  389.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 3
  390.                                                    CHAPTER 1 / INSTALLATION
  391.         -------------------------------------------------------------------
  392.  
  393.  
  394.  
  395.         CHAPTER 1 / INSTALLATION
  396.  
  397.  
  398.         You can install your copy of 4DOS automatically or manually.
  399.  
  400.         If you prefer an automated installation, our installation software
  401.         will set up 4DOS for you quickly and with very little intervention
  402.         on your part, other than answering the questions on your screen.
  403.  
  404.         If you prefer to install 4DOS yourself, you'll need to use the
  405.         installation software to copy the 4DOS files to your disk.  You can
  406.         then modify your system manually as explained below.
  407.  
  408.         If you're installing a downloaded update to 4DOS, see the
  409.         instructions under Manual Installation on page  7.
  410.  
  411.         (If you're using DOS 2.x, you must use manual installation.  The
  412.         automated installation software cannot modify CONFIG.SYS for you
  413.         under DOS 2.  See page  14 for additional details.)
  414.  
  415.         No matter which method you choose, you'll find that 4DOS's
  416.         installation software is very well-behaved.  It won't modify or
  417.         erase any existing files, including CONFIG.SYS and AUTOEXEC.BAT,
  418.         without asking you, and it takes a very straightforward, step by
  419.         step approach.
  420.  
  421.         The installation software always prompts you for the directory to
  422.         use for your 4DOS files, and will create a new directory if
  423.         necessary.  If you are upgrading from a previous version of 4DOS,
  424.         use a new directory for the new version, rather than overwriting
  425.         your existing files.  Transfer any necessary configuration files
  426.         from the old directory (e.g. 4DOS.INI, 4START, etc.), then remove
  427.         the old directory once the new version is up and running.
  428.  
  429.  
  430.         Preparing for Installation Under DOS
  431.  
  432.              If you're running DOS (or DOS plus Windows), you should make a
  433.              bootable system diskette before you install 4DOS (or any other
  434.              software, for that matter).  This allows you to recover in
  435.              case of a power failure or other interruption during the
  436.              installation process.
  437.  
  438.              To make the bootable floppy disk, put a fresh diskette in
  439.              drive A and then type:
  440.  
  441.                   format a: /s
  442.  
  443.  
  444.  
  445.  
  446.         -------------------------------------------------------------------
  447.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 4
  448.                                                    CHAPTER 1 / INSTALLATION
  449.         -------------------------------------------------------------------
  450.  
  451.  
  452.              The FORMAT command will take a few minutes to prepare the
  453.              floppy diskette, and will then copy your system files to drive
  454.              A.
  455.  
  456.              Once the process is complete, you should test your bootable
  457.              floppy by leaving it in drive A and simultaneously pressing
  458.              the Ctrl, Alt, and Del keys to make sure your system will boot
  459.              up properly.  Once you can boot from a floppy disk and access
  460.              the configuration files on your hard disk, put the floppy away
  461.              in a safe place and reboot your computer normally.
  462.  
  463.              If you use compression software on your hard disk, you may not
  464.              be able to access the hard disk from a bootable floppy unless
  465.              you copy the appropriate device drivers and other software,
  466.              plus a version of your CONFIG.SYS and AUTOEXEC.BAT files, to
  467.              the floppy disk.  See your compression software documentation
  468.              for details about creating a bootable floppy disk.
  469.  
  470.  
  471.         Preparing for Installation Under OS/2
  472.  
  473.              If you are running OS/2, a bootable floppy disk is not
  474.              required.  To begin the installation simply start a DOS
  475.              command line session and follow the automated or manual
  476.              installation instructions below.
  477.  
  478.              If you also have our OS/2 command processor, 4OS2, do not
  479.              install 4DOS in the same directory as 4OS2.  Some file names
  480.              (for example README.DOC) are the same in both products, and
  481.              the files should be kept separate to avoid confusion later.
  482.  
  483.              If you use OS/2's Dual Boot or Boot Manager facilities to
  484.              switch between DOS and OS/2, your system has two sets of
  485.              CONFIG.SYS and AUTOEXEC.BAT files:  one for DOS and one for
  486.              OS/2.  In most cases, you'll want to modify both sets, so that
  487.              4DOS is available in both environments.  If you use automated
  488.              installation, the installation software modifies only one set:
  489.              the one for the operating system you are running at the time
  490.              of installation.
  491.  
  492.              After installation, you can modify either set of configuration
  493.              files manually using the instructions under Manual
  494.              Installation on page 7.  If you use Boot Manager, you can
  495.              instead restart the installation software and select the
  496.              "Modify Startup Files" option on the main menu to modify the
  497.              second set of startup files.  If you use this approach, be
  498.              sure to tell the installation software the proper boot drive
  499.              for the set of configuration files you wish to modify.
  500.  
  501.  
  502.  
  503.  
  504.         -------------------------------------------------------------------
  505.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 5
  506.                                                    CHAPTER 1 / INSTALLATION
  507.         -------------------------------------------------------------------
  508.  
  509.  
  510.              See Chapter 4 on page 42 for more details on using 4DOS with
  511.              OS/2.
  512.  
  513.  
  514.         Automated Installation
  515.  
  516.              To begin the automated installation process, put the
  517.              distribution diskette into drive A.  You can use drive B if
  518.              you prefer, in which case you should substitute "b" for "a" in
  519.              the instructions below.
  520.  
  521.              One of the files on the distribution diskette, README.1ST,
  522.              contains information that you should read before you install
  523.              4DOS on your computer.  Type:
  524.  
  525.                   type a:readme.1st | more
  526.  
  527.              to view the file.  If you want to print a copy of the file,
  528.              type:
  529.  
  530.                   copy a:readme.1st prn
  531.  
  532.              After checking README.1ST, you can start the installation
  533.              process.  Type:
  534.  
  535.                   a:install
  536.  
  537.              and press the Enter key.
  538.  
  539.              Once the installation program has started, just follow the
  540.              instructions on the screen and 4DOS will install itself on
  541.              your system.
  542.  
  543.              The installation program will ask whether you want to perform
  544.              a complete installation, perform a partial installation in
  545.              order to run the Guided Tour, or retrieve individual files
  546.              from the 4DOS library.  Choose a full installation to install
  547.              4DOS on your system, and modify CONFIG.SYS and AUTOEXEC.BAT
  548.              (you will be prompted for permission before these files are
  549.              modified).  Choose the Tour option if you want to see what
  550.              4DOS can do before you install it permanently.
  551.  
  552.              If you elect to perform a full installation, reboot your
  553.              computer when the installation program is done.  You will then
  554.              have all the power of 4DOS available to you.
  555.  
  556.          ##  If you use a utility which allows multiple configurations in
  557.              your DOS CONFIG.SYS file, the automatic installation software
  558.              may not be able to modify CONFIG.SYS for you, even if you give
  559.              it permission to do so.  In this case you will see a message
  560.  
  561.  
  562.         -------------------------------------------------------------------
  563.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 6
  564.                                                    CHAPTER 1 / INSTALLATION
  565.         -------------------------------------------------------------------
  566.  
  567.  
  568.              explaining the problem during installation, and you will need
  569.              to follow the Manual Installation instructions below to modify
  570.              CONFIG.SYS yourself.  See page 14 for additional notes about
  571.              using 4DOS with these utilities.
  572.  
  573.              You can halt the installation process at any time by pressing
  574.              Ctrl-X (hold down the Ctrl key and then press "X").
  575.  
  576.  
  577.         ## Manual Installation
  578.  
  579.              The 4DOS files are contained in a special library file on the
  580.              distribution diskette.  You cannot simply copy files from the
  581.              diskette onto your system.  You must use the installation
  582.              program to extract the 4DOS files if you want to perform a
  583.              manual installation, or if you need to replace a damaged 4DOS
  584.              file on your hard disk.
  585.  
  586.              If you want to install 4DOS manually, first start the
  587.              automatic installation program using the instructions above.
  588.              Select the Extract all files option and extract the 4DOS files
  589.              onto your hard disk (be sure to place the files in their own
  590.              directory).
  591.  
  592.              If you are installing 4DOS on floppy disks, you may not be
  593.              able to use the Extract all files option because the files may
  594.              not fit on a single diskette.  Select Copy individual files
  595.              instead, and repeat the process two or more times to copy the
  596.              files to separate diskettes.  If possible, you should copy
  597.              4DOS.COM, KSTACK.COM, 4HELP.EXE, and 4DOS.HLP to a single
  598.              diskette, because these are the files required to operate 4DOS
  599.              with all of its features.  If these files do not fit on one
  600.              diskette, copy 4DOS.COM and KSTACK.COM to one disk and
  601.              4HELP.EXE and 4DOS.HLP to another.
  602.  
  603.              If you're installing a downloaded update to 4DOS, you will not
  604.              have an INSTALL program.  Instead, use the appropriate
  605.              decompression program (for example, PKUNZIP) to extract the
  606.              files from your download into a new directory.  Then follow
  607.              the instructions below to complete your installation.  Be sure
  608.              to check the README.DOC file for any additional update
  609.              instructions.
  610.  
  611.              Once you've extracted the files, you can go through the Guided
  612.              Tour if you want to try 4DOS before completing the
  613.              installation (see the separate Guided Tour documentation).
  614.  
  615.              When you're ready to finish the installation process, all you
  616.              need to do is add one line to your DOS or OS/2 CONFIG.SYS file
  617.  
  618.  
  619.  
  620.         -------------------------------------------------------------------
  621.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 7
  622.                                                    CHAPTER 1 / INSTALLATION
  623.         -------------------------------------------------------------------
  624.  
  625.  
  626.              (before modifying the DOS CONFIG.SYS file, be sure you have a
  627.              bootable floppy disk as discussed on page 4):
  628.  
  629.                   SHELL=d:\path\4DOS.COM d:\path /P
  630.  
  631.              "d:\path" means the drive and directory where your 4DOS files
  632.              are stored.  The second "d:\path" on the SHELL= line sets the
  633.              COMSPEC path (see page 17) and can be left out if 4DOS.COM is
  634.              in the root directory of your boot drive.  Be sure to delete
  635.              or REMark out any old SHELL= line for COMMAND.COM after you
  636.              add the new SHELL= line for 4DOS.  Once you have 4DOS up and
  637.              running, see page 11 for additional options you can use on the
  638.              SHELL= line.
  639.  
  640.              If you are running 4DOS under OS/2, change CONFIG.SYS as
  641.              described above.  Once you reboot, 4DOS will be used
  642.              automatically for all newly-created DOS objects on your
  643.              desktop, and for all DOS objects which use the default
  644.              DOS_SHELL settings.  See page 42 for more details on
  645.              configuring OS/2 DOS sessions to use 4DOS.
  646.  
  647.              Next, add the following line to your AUTOEXEC.BAT file:
  648.  
  649.                   d:\path\KSTACK.COM
  650.  
  651.              where "d:\path" is the drive and directory where your 4DOS
  652.              files are stored.  The same line can be used for DOS and for
  653.              OS/2 DOS sessions.
  654.  
  655.              When you've finished modifying CONFIG.SYS and AUTOEXEC.BAT,
  656.              reboot your system to start 4DOS.  For additional details on
  657.              setting up the SHELL= line and AUTOEXEC.BAT, see Chapter 2 /
  658.              Configuration (page 10).  See your Reference Manual for
  659.              information on the 4DOS.INI file, which controls 4DOS
  660.              configuration.
  661.  
  662.          ##  If you use a utility which allows multiple configurations in
  663.              your DOS CONFIG.SYS file, see page 14 for additional notes on
  664.              configuring 4DOS properly on your system.
  665.  
  666.  
  667.         ## Uninstalling 4DOS
  668.  
  669.              We don't expect you to have any trouble using 4DOS, but we
  670.              know some people feel more comfortable knowing how to
  671.              uninstall a product as well as install it.  Or, you may need
  672.              to remove 4DOS from one system if you are moving it to another
  673.              system.
  674.  
  675.  
  676.  
  677.  
  678.         -------------------------------------------------------------------
  679.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 8
  680.                                                    CHAPTER 1 / INSTALLATION
  681.         -------------------------------------------------------------------
  682.  
  683.  
  684.              To temporarily remove 4DOS from your system, first find the
  685.              location of COMMAND.COM on your disk (for example, in the root
  686.              directory, or the DOS directory).  Use your editor to edit
  687.              CONFIG.SYS (before modifying the DOS CONFIG.SYS file be sure
  688.              you have a bootable floppy disk as discussed on page 4).
  689.  
  690.              Look for the line which begins with SHELL=, and insert the
  691.              characters "REM " at the beginning of the line.  This converts
  692.              the line into a "remark" or comment.  (If you are using DOS 3
  693.              or below, REMarks are not recognized in CONFIG.SYS, so the
  694.              changed lines will produce a harmless "Unrecognized command"
  695.              error when the system boots.)  Next, add a new line like this:
  696.  
  697.                   SHELL=d:\path\COMMAND.COM /P
  698.  
  699.              where "d:\path" is the drive and directory for COMMAND.COM.
  700.              If you were previously running COMMAND.COM with a /E:nnnn
  701.              switch to set the size of your environment, you should add it
  702.              to this line as well.
  703.  
  704.              After CONFIG.SYS has been modified, edit your AUTOEXEC.BAT
  705.              file to remove any changes made to accommodate 4DOS.  Look for
  706.              a command beginning SET COMSPEC= and another which loads the
  707.              4DOS file KSTACK.COM.  The SET COMSPEC command will not be
  708.              present on most systems.  If it's there, change it to read:
  709.  
  710.                   SET COMSPEC=d:\path\COMMAND.COM
  711.  
  712.              where "d:\path" is replaced by the correct drive and directory
  713.              for COMMAND.COM.  Then add "REM " in front of  the KSTACK.COM
  714.              command to convert it to a comment.
  715.  
  716.              If you wish, you can also look for the PATH command, and
  717.              remove the 4DOS directory from the directories listed there.
  718.              However, there's probably no reason to do so unless you're
  719.              permanently removing 4DOS from your system.
  720.  
  721.              Now reboot your system, and you should be back up and running
  722.              under COMMAND.COM.  To switch back to 4DOS, edit your
  723.              CONFIG.SYS file again to remove the REMs on your 4DOS lines
  724.              and put one on your COMMAND.COM line instead, remove any SET
  725.              COMSPEC command in AUTOEXEC.BAT, and you can boot with 4DOS
  726.              again.
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.         -------------------------------------------------------------------
  737.         Copr. 1994 JP Software Inc.    4DOS Intro. & Installation Guide / 9
  738.                                                   CHAPTER 2 / CONFIGURATION
  739.         -------------------------------------------------------------------
  740.  
  741.  
  742.  
  743.         CHAPTER 2 / CONFIGURATION
  744.  
  745.  
  746.         This chapter explains how you can tune 4DOS to make it as efficient
  747.         and as useful as possible in your computing environment.  Nearly
  748.         everything in this chapter is for advanced users and those with
  749.         unusual needs.  If 4DOS works the way you want it to after the
  750.         automatic installation, you can skip this chapter.  You may,
  751.         however, want to skim this material to see what options are
  752.         available.
  753.  
  754.  
  755.         Configuration Files
  756.  
  757.              4DOS uses or is affected by five configuration files.  Two are
  758.              for general DOS configuration; the other three are unique to
  759.              4DOS.  The general DOS files are CONFIG.SYS and AUTOEXEC.BAT.
  760.              The specialized 4DOS files are called 4START, 4EXIT, and
  761.              4DOS.INI.
  762.  
  763.              CONFIG.SYS is discussed below.  AUTOEXEC.BAT, 4START and 4EXIT
  764.              are discussed briefly below, and in Chapter 4 / Aliases and
  765.              Batch Files in the Reference Manual.  4DOS.INI is discussed in
  766.              Chapter 5 / Configuration in the Reference Manual.
  767.  
  768.          !   Anytime you change a configuration file, a typographical
  769.              mistake or other error could make your system lock up or run
  770.              erratically.  Before you make any changes to any of these
  771.              files, we strongly urge you to take some precautions.  (These
  772.              precautions are for DOS users.  Under OS/2 they can be
  773.              helpful, but are not required, because problems with the
  774.              startup files are not as likely to keep the system from
  775.              booting and prevent you from editing the incorrect file.)
  776.  
  777.              First, create a bootable floppy disk (see page 4).  Second,
  778.              make a backup copy of all five configuration files, giving the
  779.              backup copies a different extension than the originals (for
  780.              example .SAV).  Copy these backup files to your boot-up floppy
  781.              for safekeeping.
  782.  
  783.              With these precautions, if something goes wrong, you will be
  784.              able to boot with your floppy disk and copy the files back to
  785.              their original names.  You'll only have to spend a few minutes
  786.              recovering your system.  You should follow the same
  787.              precautions each time you install a new application program
  788.              that changes your DOS or 4DOS configuration files.
  789.  
  790.  
  791.  
  792.  
  793.  
  794.         -------------------------------------------------------------------
  795.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 10
  796.                                                   CHAPTER 2 / CONFIGURATION
  797.         -------------------------------------------------------------------
  798.  
  799.  
  800.         Setting Up CONFIG.SYS
  801.  
  802.              The DOS CONFIG.SYS file contains instructions for DOS to
  803.              execute before it loads a command processor.  The OS/2
  804.              CONFIG.SYS file contains similar startup instructions for
  805.              OS/2.  Only one line in the CONFIG.SYS file affects 4DOS.  It
  806.              tells the operating system to use 4DOS as the DOS command
  807.              processor instead of COMMAND.COM.  The format of this line is:
  808.  
  809.                   SHELL=d:\path\4DOS.COM [d:\path] [@d:\path\inifile]
  810.                        [//iniline]... [/D] [/E:nnnn] [/F] [/L] [/LA] [/LH]
  811.                        [/LD] [/Y] [/P[:filename]] [[/K]command]
  812.  
  813.              SHELL= identifies this line as defining the command processor
  814.              that DOS will load after it finishes executing CONFIG.SYS, or
  815.              that OS/2 will load when a DOS session is started.
  816.  
  817.              Replace the first "d:\path\" (immediately after SHELL=) with
  818.              the 4DOS drive and directory.  If you're using DOS, the drive
  819.              and path must be correct or your system won't boot (and you'll
  820.              be very happy that you made the boot-up floppy we suggested).
  821.  
  822.              The remainder of the items on this line are optional.  If they
  823.              are used, you should not include the square brackets.  In the
  824.              descriptions below, "d:" means a drive letter and "\path"
  825.              means a subdirectory name.
  826.  
  827.                   d:\path:  This is the second d:\path above (not the one
  828.                   immediately after SHELL=).  It sets the drive and
  829.                   directory where 4DOS is stored, called the COMSPEC path.
  830.                   4DOS uses this path to find its files and to set the
  831.                   COMSPEC environment variable (see page 17).
  832.  
  833.                   If you use MS-DOS or PC-DOS 3.0 or above, 4DOS will
  834.                   normally find its directory automatically and this option
  835.                   will not be needed.  If you run 4DOS under OS/2, or use
  836.                   Novell DOS or DR DOS, this option is required unless
  837.                   4DOS.COM is in the root directory of the boot drive.
  838.  
  839.                   @d:\path\inifile:  This option sets the path and name of
  840.                   the 4DOS.INI file.  You don't need this option if you
  841.                   aren't using an .INI file at all, or if the file is
  842.                   called 4DOS.INI and it is in the same directory as
  843.                   4DOS.COM, or in the root directory of the boot drive.
  844.  
  845.                   //iniline:  This option tells 4DOS to treat the text
  846.                   appearing between the // and the next space or tab as a
  847.                   4DOS.INI directive.  The directive should be in the same
  848.                   format as a line in 4DOS.INI, but may not contain spaces,
  849.                   tabs, or comments.  Directives on the SHELL= line
  850.  
  851.  
  852.         -------------------------------------------------------------------
  853.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 11
  854.                                                   CHAPTER 2 / CONFIGURATION
  855.         -------------------------------------------------------------------
  856.  
  857.  
  858.                   override any corresponding directive in 4DOS.INI.  This
  859.                   is a convenient way to place one or two simple directives
  860.                   on the SHELL= line without having to modify or create a
  861.                   4DOS.INI file.
  862.  
  863.                   /D:  This option disables execution of AUTOEXEC.BAT (or
  864.                   the file named in the AutoExecPath directive in 4DOS.INI
  865.                   or on the SHELL= line).  It is intended for internal use
  866.                   by MS-DOS / PC-DOS 6.x.  When you press the F8 key during
  867.                   the boot process, MS-DOS prompts for whether to run
  868.                   AUTOEXEC.BAT.  If you answer "No", the /D switch is used
  869.                   to relay your choice to 4DOS.
  870.  
  871.                   /E:nnnn:  This option sets the size of the environment,
  872.                   in bytes.  If you don't use this option, 4DOS will
  873.                   allocate 512 bytes for the environment.  You can use any
  874.                   value from 256 to 32000 as the environment size.  For
  875.                   example, to set an environment of 1,000 bytes, you would
  876.                   enter the option as /E:1000.
  877.  
  878.                   You can also set the environment size with the
  879.                   Environment directive in the 4DOS.INI file (see your
  880.                   Reference Manual).
  881.  
  882.                   /F:  This option tells 4DOS to automatically provide a
  883.                   Fail response to all critical errors, without prompting
  884.                   or waiting for a user response.  It is rarely used except
  885.                   on systems that must run unattended, like bulletin
  886.                   boards.  We do not recommend use of this option on a
  887.                   normal system, because you will not have a chance to
  888.                   react to a critical error and correct the problem that
  889.                   caused it.  For more information on critical errors see
  890.                   Chapter 3 of your Reference Manual.  /F only affects
  891.                   critical errors detected by 4DOS, and will not affect
  892.                   critical error handling for many application programs
  893.                   which perform this function themselves.  It is equivalent
  894.                   to the directive CritFail=Yes in 4DOS.INI.
  895.  
  896.                   /L, /LA, /LD, and /LH:  These options force 4DOS to use a
  897.                   local alias, directory history, and / or command history
  898.                   list.  They can be used to override any LocalAlias=No,
  899.                   LocalHistory=No, or LocalDirHistory=No settings in
  900.                   4DOS.INI.  This allows you to use global lists as the
  901.                   default, but start a specific shell or OS/2 DOS session
  902.                   with local aliases or history.  See your Reference Manual
  903.                   for details on local and global aliases and history.  /LA
  904.                   forces local aliases, /LD forces local directory history,
  905.                   /LH forces local command history, and /L forces all 3:
  906.                   local aliases, command history, and directory history.
  907.  
  908.  
  909.  
  910.         -------------------------------------------------------------------
  911.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 12
  912.                                                   CHAPTER 2 / CONFIGURATION
  913.         -------------------------------------------------------------------
  914.  
  915.  
  916.                   /Y:  This option forces 4DOS to "single-step" through
  917.                   4START and AUTOEXEC.BAT (or the file named in the
  918.                   AutoExecPath directive).  It is intended for internal use
  919.                   by MS-DOS 6.x.  When you press the F8 key to enable
  920.                   single-stepping during the boot process, the /Y switch is
  921.                   used to relay your choice to 4DOS.
  922.  
  923.                   /P[:filename]:  This option tells 4DOS to load
  924.                   permanently and to run AUTOEXEC.BAT.  If you specify a
  925.                   filename after the /P, that file will be run instead of
  926.                   AUTOEXEC.BAT.  You should specify the full name of the
  927.                   file, including drive and directory.  A filename after /P
  928.                   will override the AutoExecPath option in 4DOS.INI.
  929.  
  930.                   When 4DOS is loaded from the SHELL= command in
  931.                   CONFIG.SYS, or as the shell for an OS/2 DOS session, it
  932.                   will normally detect that it is the primary shell and set
  933.                   the /P option automatically.  Under very rare
  934.                   circumstances, you may want to load 4DOS permanently and
  935.                   have it run AUTOEXEC even though you are not loading it
  936.                   from CONFIG.SYS; in such cases you must set /P yourself.
  937.                   4DOS will not run AUTOEXEC.BAT without either an
  938.                   automatic or an explicit /P.  Do not use this option in
  939.                   secondary shells, or you will be unable to return to the
  940.                   primary shell.
  941.  
  942.                   [/K] command:  This option tells 4DOS to run the command
  943.                   after 4START and AUTOEXEC.BAT but before displaying the
  944.                   prompt.  The command can be any valid alias, internal or
  945.                   external command, or batch file.  All other startup
  946.                   options (such as //iniline or /P) must be placed before
  947.                   the command, because 4DOS will treat characters after the
  948.                   command as part of the command and not as additional
  949.                   startup options.
  950.  
  951.                   If you use MS-DOS / PC-DOS 6.x and use /K, the command
  952.                   will be executed instead of AUTOEXEC.BAT (for
  953.                   compatibility with MS-DOS / PC-DOS 6.x COMMAND.COM).  In
  954.                   all other cases, the command will be executed in addition
  955.                   to AUTOEXEC.BAT.
  956.  
  957.          ##  If you specify a path and name for the 4DOS.INI file on the
  958.              SHELL= line, or if you use options that will override
  959.              directives in your .INI file, you must place the command line
  960.              options on the SHELL= line in the order in which they are
  961.              listed above.  If you do not, you may find that the command
  962.              line options do not properly override directives in the .INI
  963.              file.
  964.  
  965.  
  966.  
  967.  
  968.         -------------------------------------------------------------------
  969.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 13
  970.                                                   CHAPTER 2 / CONFIGURATION
  971.         -------------------------------------------------------------------
  972.  
  973.  
  974.              Caution
  975.  
  976.          !   There is a bug in all versions of MS-DOS and PC-DOS from 2.0
  977.              through 4.01:  the SHELL= line in the CONFIG.SYS file may not
  978.              contain more than 31 characters following the name of the
  979.              shell program (i.e., beginning with the space after
  980.              "4DOS.COM").  If the line is too long, the options will not be
  981.              passed properly to 4DOS and a variety of errors can occur.
  982.              You can set all necessary 4DOS options without exceeding this
  983.              limit, especially if you put 4DOS.COM and 4DOS.INI in the root
  984.              directory of your boot drive.  This limit is not present in
  985.              MS-DOS / PC-DOS 5.0 and above, in Novell DOS, or in OS/2.
  986.  
  987.  
  988.           ## 4DOS and Multiple-Configuration Utilities
  989.  
  990.              4DOS is fully compatible with most products which allow
  991.              multiple configurations in your DOS CONFIG.SYS file, including
  992.              BOOT.SYS (a powerful multiple-configuration utility sold by JP
  993.              Software), and the MS-DOS / PC-DOS 6.0 and above "multi-
  994.              config" feature.
  995.  
  996.              If you plan to use the same 4DOS setup for all configurations,
  997.              create one SHELL= line and place it in the common area of
  998.              CONFIG.SYS that is used for all configurations.
  999.  
  1000.              If you want to use a separate 4DOS setup for each
  1001.              configuration, create individual SHELL= lines in the area of
  1002.              CONFIG.SYS specific to each configuration.  Start out using
  1003.              the same line for each configuration, then make any necessary
  1004.              changes to your standard setup.  For example, you could use
  1005.              options on the SHELL= line to select a different .INI file or
  1006.              AUTOEXEC file for certain configurations (see above for more
  1007.              details on these options).
  1008.  
  1009.              Be sure to check APPNOTES.DOC for notes on the specific
  1010.              configuration utility you use.
  1011.  
  1012.  
  1013.              4DOS and DOS 2
  1014.  
  1015.              We recommend using DOS 3.1 or above, but 4DOS can be used with
  1016.              DOS 2.  The only special consideration is that 4DOS must be
  1017.              loaded differently under DOS 2.x, because certain DOS 2
  1018.              functions require that COMMAND.COM be loaded as the primary
  1019.              command processor.  Therefore, you must load COMMAND.COM first
  1020.              and then 4DOS.  Assuming that all files are in the root
  1021.              directory of your boot drive, the SHELL= line in DOS 2.x
  1022.              should look like this:
  1023.  
  1024.  
  1025.  
  1026.         -------------------------------------------------------------------
  1027.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 14
  1028.                                                   CHAPTER 2 / CONFIGURATION
  1029.         -------------------------------------------------------------------
  1030.  
  1031.  
  1032.                   shell=command.com /c 4DOS /p [options]
  1033.  
  1034.              Note that due to the "/c 4DOS" on the SHELL line, fewer
  1035.              options can be used before running into the 31-character limit
  1036.              discussed above.  You must, however, use the /P option, or
  1037.              AUTOEXEC.BAT will not run.  4DOS will not automatically detect
  1038.              that it is the primary shell and set /P for you when run under
  1039.              DOS 2.
  1040.  
  1041.  
  1042.         Startup Options for Secondary Shells
  1043.  
  1044.              You may want to set explicit options for a 4DOS secondary
  1045.              shell when you define a 4DOS window in a task switching or
  1046.              multitasking system such as Windows, DESQview, Back & Forth,
  1047.              or the MS-DOS shell (DOSSHELL); when you "shell out" of a
  1048.              program which allows you to specify command-line options for
  1049.              the shell; or in rare cases when you run a secondary copy of
  1050.              4DOS directly from the command line.  In most other cases,
  1051.              secondary shells do not use or require any startup options.
  1052.  
  1053.              If you do need to set options for secondary shells, you can
  1054.              use any of the following (for more details on items which are
  1055.              the same as those used in CONFIG.SYS, see the section
  1056.              beginning on page 11):
  1057.  
  1058.                   @d:\path\inifile:  Set the .INI file name, as in
  1059.                   CONFIG.SYS.  This option is not necessary if you want
  1060.                   4DOS to use the same .INI file that you used for the
  1061.                   primary shell, because values from that file - including
  1062.                   those in its [Secondary] section - will be passed
  1063.                   automatically to secondary shells.
  1064.  
  1065.                   //iniline:  This option tells 4DOS to treat the text
  1066.                   appearing between the // and the next space or tab as a
  1067.                   4DOS.INI directive.  The directive should be in the same
  1068.                   format as a line in 4DOS.INI, but may not contain spaces,
  1069.                   tabs, or comments.  Directives on the secondary shell
  1070.                   command line override any corresponding directive in
  1071.                   4DOS.INI.  This allows you to use 4DOS.INI directives
  1072.                   directly on the command line when starting 4DOS in a
  1073.                   window of a multitasking system, rather than having to
  1074.                   create separate copies of 4DOS.INI to accommodate small
  1075.                   configuration changes in different windows.
  1076.  
  1077.                   /E:nnnn:  Set the environment size, as in CONFIG.SYS.
  1078.  
  1079.                   /F:  Force an automatic "Fail" on critical error, as in
  1080.                   CONFIG.SYS.
  1081.  
  1082.  
  1083.  
  1084.         -------------------------------------------------------------------
  1085.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 15
  1086.                                                   CHAPTER 2 / CONFIGURATION
  1087.         -------------------------------------------------------------------
  1088.  
  1089.  
  1090.                   /L, /LA, /LD, and /LH:  Force 4DOS to use a local alias,
  1091.                   directory history and / or command history list, as in
  1092.                   CONFIG.SYS.
  1093.  
  1094.                   [/C | /K] command:  This option tells 4DOS to run the
  1095.                   command after 4START but before any command prompt is
  1096.                   displayed.  The command can be any valid alias, internal
  1097.                   or external command, or batch file, and can include
  1098.                   multiple commands.  Use this option if you want 4DOS to
  1099.                   run a batch file or execute a command when it starts, for
  1100.                   example to run a specific batch file when 4DOS is started
  1101.                   in a window of a multitasking system.
  1102.  
  1103.                   When the command is preceded by a /C, 4DOS will execute
  1104.                   it and then exit and return to the parent program.  /C is
  1105.                   used by some applications to start the command processor,
  1106.                   run one command, and then return to the application.
  1107.  
  1108.                   The /K switch is included only for compatibility with
  1109.                   COMMAND.COM.  It has no effect on 4DOS; using it is the
  1110.                   same as placing the command (without a /C or /K) at the
  1111.                   end of the startup command line.
  1112.  
  1113.  
  1114.         Using AUTOEXEC.BAT, 4START, and 4EXIT
  1115.  
  1116.              You generally won't need to make any changes to AUTOEXEC.BAT
  1117.              to make it run properly under 4DOS, although once you get used
  1118.              to 4DOS's batch file enhancements, you may want to use them to
  1119.              streamline AUTOEXEC.
  1120.  
  1121.              If you want to use the 4DOS KEYSTACK command, you will
  1122.              normally load the program KSTACK.COM from your AUTOEXEC.BAT
  1123.              file.  To do so, include the following line in your file (be
  1124.              sure to place it before any KEYSTACK commands):
  1125.  
  1126.                   d:\path\kstack.com
  1127.  
  1128.              Replace d:\path with the path to the KSTACK.COM program, which
  1129.              will normally be stored in your 4DOS directory.
  1130.  
  1131.              You may want to use AUTOEXEC.BAT to configure 4DOS by setting
  1132.              the environment variables that 4DOS uses:  CDPATH, COLORDIR,
  1133.              COMSPEC, PATH, PROMPT, TEMP, and TEMP4DOS.  You may also want
  1134.              to include a SETDOS command to set configuration variables.
  1135.              All of these settings are optional.
  1136.  
  1137.              4DOS runs two special batch files automatically, 4START and
  1138.              4EXIT.  4START is executed whenever 4DOS is started.  In the
  1139.              primary shell, it is executed before AUTOEXEC.BAT.  If 4DOS is
  1140.  
  1141.  
  1142.         -------------------------------------------------------------------
  1143.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 16
  1144.                                                   CHAPTER 2 / CONFIGURATION
  1145.         -------------------------------------------------------------------
  1146.  
  1147.  
  1148.              started as a secondary shell with the [/C] command option,
  1149.              4START is executed before the command.
  1150.  
  1151.              See your Reference Manual for more information on environment
  1152.              variables, the SETDOS command, and AUTOEXEC.BAT, 4START, and
  1153.              4EXIT.
  1154.  
  1155.  
  1156.         COMSPEC and the COMSPEC Path
  1157.  
  1158.              The COMSPEC environment variable contains the full path and
  1159.              name of the command processor.  For example, if 4DOS is stored
  1160.              in the directory C:\4DOS, the COMSPEC variable should be set
  1161.              to C:\4DOS\4DOS.COM.  COMSPEC is used by applications which
  1162.              need to find the command processor to implement a "shell to
  1163.              DOS" feature.
  1164.  
  1165.              You can set the COMSPEC variable by specifying the COMSPEC
  1166.              path when your system starts, or by using a SET command as you
  1167.              would for any environment variable.
  1168.  
  1169.              If you include a COMSPEC path on the SHELL= line in CONFIG.SYS
  1170.              (see page 11), or in the DOS_SHELL setting for an OS/2 2.x DOS
  1171.              session (see page 47), 4DOS will set the COMSPEC variable
  1172.              automatically to the path you specify, and append the filename
  1173.              4DOS.COM.  This method also allows 4DOS to use the COMSPEC
  1174.              path to find other files during the startup process, such as
  1175.              4DOS.INI and 4START.
  1176.  
  1177.              If you don't include the COMSPEC path on the primary shell's
  1178.              startup command line, 4DOS will set the COMSPEC variable to
  1179.              the root directory of the boot drive (x:\4DOS.COM where "x" is
  1180.              the boot drive), and will also look in the root directory of
  1181.              the boot drive for 4DOS.INI and 4START.
  1182.  
  1183.              You can also set the COMSPEC variable manually with a SET
  1184.              command in AUTOEXEC.BAT.  This method will override any
  1185.              setting made with a COMSPEC path on the primary shell's
  1186.              startup command line as described above.  We do not recommend
  1187.              this approach, because it will allow applications to shell to
  1188.              DOS, but will not provide the information the primary 4DOS
  1189.              shell needs to find its files during the startup process.
  1190.  
  1191.              When 4DOS is running as the primary command processor, you can
  1192.              determine whether COMSPEC has been set correctly by typing the
  1193.              following line at the 4DOS prompt:
  1194.  
  1195.                   echo %comspec
  1196.  
  1197.  
  1198.  
  1199.  
  1200.         -------------------------------------------------------------------
  1201.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 17
  1202.                                                   CHAPTER 2 / CONFIGURATION
  1203.         -------------------------------------------------------------------
  1204.  
  1205.  
  1206.         4DOS Swapping Methods
  1207.  
  1208.              4DOS runs in two parts, a resident portion that is always in
  1209.              memory and a transient portion that can be stored in EMS
  1210.              memory, in XMS memory, on a RAM disk, or on your hard disk
  1211.              while application programs are running.  The resident portion
  1212.              uses about 3K bytes of memory in the primary shell and about
  1213.              1.5K bytes in secondary shells.  The transient portion uses
  1214.              about 128K bytes of memory.  4DOS will perform most quickly if
  1215.              the transient portion is swapped to the fastest memory or
  1216.              device available.
  1217.  
  1218.              See page 24 for explanations of XMS and EMS memory.
  1219.  
  1220.              Swapping for the primary shell normally requires about 128K
  1221.              bytes of EMS memory, XMS memory, or disk space.  Secondary
  1222.              shells normally require 32K bytes of EMS, or 28K bytes of XMS
  1223.              or disk space.  If you have a large environment, alias list,
  1224.              or history list, more memory will be required in both primary
  1225.              and secondary shells.  The EMS requirements are larger because
  1226.              EMS memory is allocated in 16K increments;  4DOS does not
  1227.              actually use more memory when swapping to EMS.
  1228.  
  1229.              You can control 4DOS swapping with the Swapping directive in
  1230.              4DOS.INI.  The Swapping directive lists a series of swap
  1231.              types, which may be:
  1232.  
  1233.                   EMS:  4DOS will swap to EMS expanded memory if it is
  1234.                   available.  You must have expanded memory and an EMS
  1235.                   memory manager (version 3.2 or later) for this option.
  1236.  
  1237.                   XMS:  4DOS will swap to XMS extended memory if it is
  1238.                   available.  You must have an an XMS memory manager and a
  1239.                   80286, 386, 486, or Pentium computer for this option.
  1240.  
  1241.                   d:\path:  4DOS will create a swap file in the drive and
  1242.                   directory specified.  The file will be called
  1243.                   4DOSSWAP.NNN where "NNN" is the shell number (unless you
  1244.                   use the UniqueSwapName directive in 4DOS.INI to generate
  1245.                   a unique swap file name).  This swap file is created as a
  1246.                   hidden system file to avoid accidental deletion and will
  1247.                   not be visible with a normal DIR command.  Swapping to a
  1248.                   RAM disk will generally be faster than swapping to a hard
  1249.                   disk.  Do not use a floppy disk for swapping because its
  1250.                   performance is likely to be unacceptably slow.
  1251.  
  1252.                   None:  No swapping.  The transient portion of 4DOS will
  1253.                   remain in memory at all times.  This option will reduce
  1254.                   memory available for application programs by about 128K
  1255.  
  1256.  
  1257.  
  1258.         -------------------------------------------------------------------
  1259.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 18
  1260.                                                   CHAPTER 2 / CONFIGURATION
  1261.         -------------------------------------------------------------------
  1262.  
  1263.  
  1264.                   compared to the other swap types, and should be used only
  1265.                   when no other swapping options are available.
  1266.  
  1267.              You can specify multiple swap types and 4DOS will try them in
  1268.              the order listed.  Swap type "None" is always appended to your
  1269.              list of possible swap types as a "last resort," even if you
  1270.              don't include it explicitly.  This allows 4DOS to start even
  1271.              if the other swap types you specify don't work.
  1272.  
  1273.              For example, if your system has EMS memory and a RAM disk set
  1274.              up as drive D, the directive:
  1275.  
  1276.                   Swapping = EMS, D:\, C:\SWAP
  1277.  
  1278.              in 4DOS.INI will tell 4DOS to try EMS memory first, then the
  1279.              RAM disk, and finally the \SWAP directory on drive C.  If all
  1280.              of these options fail (because there isn't enough free space
  1281.              available), the transient portion of 4DOS will remain in
  1282.              memory (swap type "None").
  1283.  
  1284.              The default Swapping specification is:
  1285.  
  1286.                   Swapping = EMS, XMS, x:\, None
  1287.  
  1288.              where "x" is the boot drive (for the primary shell) or the
  1289.              COMSPEC drive (for secondary shells).  (Disk swapping will not
  1290.              be included as part of the default if the boot drive is A: or
  1291.              B:, because floppy disk swapping is too slow to be useful on
  1292.              most systems.)
  1293.  
  1294.              After 4DOS starts, you can use the SWAPPING command to view
  1295.              the type of swapping in use.
  1296.  
  1297.  
  1298.         4DOS Help
  1299.  
  1300.              4DOS includes a complete help program called 4HELP.EXE.  The
  1301.              help system includes complete help for all 4DOS internal
  1302.              commands, all standard DOS external commands, and most 4DOS
  1303.              features.  The information in the help system is fully cross-
  1304.              referenced, so you can move easily among related commands.
  1305.  
  1306.              You can start the help system by typing HELP (or HELP plus a
  1307.              command name) at the prompt, or by pressing the F1 key at any
  1308.              time at the command line.
  1309.  
  1310.              If you type part or all of a command on the line and then
  1311.              press F1, the help system will provide "context-sensitive"
  1312.              help by using the first word on the line as a help topic.  If
  1313.              it's a valid topic, you will see help for that topic
  1314.  
  1315.  
  1316.         -------------------------------------------------------------------
  1317.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 19
  1318.                                                   CHAPTER 2 / CONFIGURATION
  1319.         -------------------------------------------------------------------
  1320.  
  1321.  
  1322.              automatically; if not, you will see the list of all help
  1323.              topics and you can pick the one you want.  For example, if you
  1324.              press F1 after entering each of the command lines shown below
  1325.              you will get the display indicated:
  1326.  
  1327.                   c:\>                Topic list
  1328.                   c:\> copy *.* a:    Help on COPY
  1329.                   c:\> c:\util\map    Topic list
  1330.  
  1331.              If you type the name of any internal command at the prompt,
  1332.              followed by a slash and a question mark [/?] like this:
  1333.  
  1334.                   copy /?
  1335.  
  1336.              then you will see help for the command in a "quick-reference"
  1337.              style.  Output from a /? display may be redirected with > or
  1338.              >>.
  1339.  
  1340.          ##  The /? option may not work correctly if you have used an alias
  1341.              to redefine how an internal command operates.  To view the /?
  1342.              help for such a command you must add an asterisk to the
  1343.              beginning of the command to disable alias processing.  For
  1344.              example, if you have defined this alias:
  1345.  
  1346.                   alias copy *copy /r
  1347.  
  1348.              then the command COPY /? will be translated to COPY /R /?,
  1349.              which will not work properly.  However, if you use *COPY /?,
  1350.              the alias will be ignored and the /? will work as you
  1351.              intended.
  1352.  
  1353.              Once you've started the 4DOS help system with HELP or F1, you
  1354.              can use a standard set of keystrokes to navigate.  The table
  1355.              below gives a summary of keys you can use in the help topic
  1356.              list, and in a help text screen.  For more details on using
  1357.              the help system, see the Help topic (at the beginning of the
  1358.              topic list) in the help system itself.  For details on mouse
  1359.              usage, see the Mouse topic in the help system.
  1360.  
  1361.              Help topic list keys:
  1362.  
  1363.                   Arrow Keys          Move the highlight to a different
  1364.                                       topic.
  1365.                   Enter               Display help on the highlighted
  1366.                                       topic.
  1367.                   Esc                 Return to 4DOS.
  1368.                   Any other key       Attempt to match the characters typed
  1369.                                       with one of the names in the topic
  1370.                                       list.
  1371.  
  1372.  
  1373.  
  1374.         -------------------------------------------------------------------
  1375.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 20
  1376.                                                   CHAPTER 2 / CONFIGURATION
  1377.         -------------------------------------------------------------------
  1378.  
  1379.  
  1380.              Help text screen keys:
  1381.  
  1382.                   Up Arrow            Scroll up one line in the display.
  1383.                   Down Arrow          Scroll down one line in the display.
  1384.                   PgUp                Scroll up one page in the display.
  1385.                   PgDn                Scroll down one page in the display.
  1386.                   Left Arrow          Move the cross-reference highlight to
  1387.                                       the previous item.
  1388.                   Right Arrow         Move the cross-reference highlight to
  1389.                                       the next item.
  1390.                   Enter               Switch to the topic shown by the
  1391.                                       highlighted cross-reference item.
  1392.                   Esc                 Return to the topic list, or back to
  1393.                                       4DOS if this topic was displayed
  1394.                                       directly without using the topic
  1395.                                       list.
  1396.                   F1                  Go to the topic list in order to
  1397.                                       select a new topic.
  1398.                   Alt-N or Ctrl-Right View the next topic in the topic
  1399.                                       list.
  1400.                   Alt-P or Ctrl-Left  View the previous topic in the topic
  1401.                                       list.
  1402.                   Alt-F1              View the previously displayed topic.
  1403.                   Alt-X               Return directly to 4DOS without
  1404.                                       restoring the original screen
  1405.                                       contents.
  1406.                   F                   Find a string within the current
  1407.                                       topic.
  1408.                   G                   Find a string in any topic (a
  1409.                                       "global" search).
  1410.                   N                   Find the next occurrence of the
  1411.                                       search string.
  1412.                   P                   Print the text for the current topic
  1413.                                       on LPT1.
  1414.  
  1415.              The help system normally restores the screen when exiting.
  1416.              Use Alt-X to leave a page of help text on the screen so you
  1417.              can refer to it.  You can use F, G, and N to search for a
  1418.              string in the help text, and P to print the topic you are
  1419.              viewing.  Your printer must be turned on and ready before
  1420.              pressing P.
  1421.  
  1422.  
  1423.              Configuring the Help System
  1424.  
  1425.              The 4DOS help system can be configured in several different
  1426.              ways.
  1427.  
  1428.              First, the HELPCFG.EXE program included with 4DOS allows you
  1429.              to customize the HELP colors.  To use it, just change to your
  1430.  
  1431.  
  1432.         -------------------------------------------------------------------
  1433.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 21
  1434.                                                   CHAPTER 2 / CONFIGURATION
  1435.         -------------------------------------------------------------------
  1436.  
  1437.  
  1438.              4DOS directory, enter the command HELPCFG, and follow the
  1439.              instructions it displays.  To force HELPCFG to adjust the
  1440.              monochrome HELP colors, even if you are using a color system,
  1441.              use the command HELPCFG /M to start the program.
  1442.  
  1443.              You can use the HelpPath directive in your 4DOS.INI file to
  1444.              inform 4DOS of the location of the HELP files (4HELP.EXE and
  1445.              4DOS.HLP).  If you don't use the HelpPath directive, the HELP
  1446.              program must be in the current directory or in one of the
  1447.              directories specified in your PATH setting.  If you use the
  1448.              HelpPath directive, the HELP command will generally respond
  1449.              more quickly because 4DOS won't have to search the directories
  1450.              in your PATH setting to find the help files.
  1451.  
  1452.              The HELP command has three options which you can set with the
  1453.              HelpOptions directive in 4DOS.INI.  The options are:
  1454.  
  1455.                   /M(onochrome):  Forces HELP to use monochrome display
  1456.                   mode.  This is useful on a system which has a color video
  1457.                   board and a monochrome display (for example, portable
  1458.                   computers with LCD screens).
  1459.  
  1460.                   /Sn (Speed):  Sets the HELP mouse movement speed.  /S0
  1461.                   sets the speed to one half the default mouse speed.  /S2
  1462.                   sets it to twice the default, and /S4 sets it to four
  1463.                   times the default.  The higher values may be useful if
  1464.                   you use a screen larger than the standard size of 80 x
  1465.                   25.
  1466.  
  1467.                   /X:  Disable the mouse while HELP is running.  If you
  1468.                   have a Microsoft serial or PS/2 mouse and are
  1469.                   experiencing long delays when HELP starts, you can use
  1470.                   this option to disable the mouse.  (The delay is caused
  1471.                   by the extended time required by some versions of the
  1472.                   Microsoft mouse driver to initialize these mice.)
  1473.  
  1474.              For example, if you want HELP to use a monochrome display and
  1475.              disable the mouse by default, you could include the following
  1476.              line in your 4DOS.INI file:
  1477.  
  1478.                   HelpOptions = /M /X
  1479.  
  1480.              You can include the same options on the HELP command line if
  1481.              you wish.  Options used on the HELP command line will override
  1482.              any that are set in the 4DOS.INI file.  For example, to obtain
  1483.              help on the COPY command, and disable the mouse, you could use
  1484.              this command:
  1485.  
  1486.                   c:\> help /x copy
  1487.  
  1488.  
  1489.  
  1490.         -------------------------------------------------------------------
  1491.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 22
  1492.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1493.         -------------------------------------------------------------------
  1494.  
  1495.  
  1496.  
  1497.         CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1498.  
  1499.  
  1500.         This chapter explains how to get the most from 4DOS with the
  1501.         particular hardware and software in use on your system.
  1502.  
  1503.         You should find that 4DOS is compatible with all your PC hardware
  1504.         and software.  We have designed it carefully so that it uses
  1505.         standard, documented methods to do its job.  It works properly with
  1506.         all kinds of CPUs, keyboards, video displays, and disks; with
  1507.         application software, utilities, networks, multitaskers and task
  1508.         switchers, and memory-resident (TSR) programs; and with system
  1509.         software like disk caches, memory managers, and device drivers.  We
  1510.         test 4DOS regularly with dozens of hardware setups and hundreds of
  1511.         popular software products in order to catch and correct any
  1512.         possible compatibility problems before you encounter them.
  1513.  
  1514.         The following sections discuss using 4DOS:
  1515.  
  1516.              * With the physical hardware that makes up your computer
  1517.                system (the CPU, Memory, Video, and Disks).
  1518.  
  1519.              * With DOS, including a specific discussion of Novell DOS.
  1520.  
  1521.              * With multitasking and task switching programs, including a
  1522.                specific discussion of Microsoft Windows.
  1523.  
  1524.              * With networks, including Novell Netware.
  1525.  
  1526.         For specific information about any individual software package or
  1527.         hardware product, including the latest information about products
  1528.         mentioned in this chapter, see the APPNOTES.DOC file distributed
  1529.         with 4DOS.  It contains the latest information available when your
  1530.         copy of 4DOS was shipped.
  1531.  
  1532.         If you need to diagnose a problem that isn't covered below or in
  1533.         APPNOTES.DOC, see Appendix A on page 53.
  1534.  
  1535.         If you have questions about some of the terms and concepts here,
  1536.         see Chapter 1 or the Glossary in your Reference Manual, or the
  1537.         Index on page 68 of this manual.
  1538.  
  1539.  
  1540.         The CPU
  1541.  
  1542.              The CPU or "Central Processing Unit" is the chip which
  1543.              performs or directs all of the work done by your computer.
  1544.              All PC CPU chips are part of or compatible with Intel's
  1545.              "80x86" family.  These include the 8088, 8086, 80188, 80186,
  1546.  
  1547.  
  1548.         -------------------------------------------------------------------
  1549.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 23
  1550.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1551.         -------------------------------------------------------------------
  1552.  
  1553.  
  1554.              80286, 386, 486, Pentium, NEC V20, and NEC V30, plus "SX"
  1555.              versions and other variations of some of those chips.  4DOS is
  1556.              compatible with all of these chips.
  1557.  
  1558.              Some systems have a numeric coprocessor as a companion to the
  1559.              CPU.  The numeric coprocessor performs many arithmetic
  1560.              calculations faster than the CPU.  4DOS does not use the
  1561.              numeric coprocessor.
  1562.  
  1563.              You can determine which CPU chip your system has by using
  1564.              4DOS's _CPU internal variable:
  1565.  
  1566.                   c:\> echo %_cpu
  1567.  
  1568.              Similarly, you can find out if you have a numeric coprocessor
  1569.              with _NDP:
  1570.  
  1571.                   c:\> echo %_ndp
  1572.  
  1573.              See your Reference Manual for details about _CPU and _NDP.
  1574.  
  1575.  
  1576.         Memory
  1577.  
  1578.              The memory in your computer is organized in bytes.  Normally,
  1579.              the amount of memory in a computer is discussed in terms of
  1580.              kilobytes (KBytes or 1,024 bytes) and megabytes (MBytes or
  1581.              1,048,576 bytes or 1,024 KBytes).  The amount of memory
  1582.              available in your computer is determined by the number of
  1583.              memory chips or memory modules you have installed.
  1584.  
  1585.              In an ideal world, there would be little more to say about
  1586.              memory.  But because of the history of PCs, the needs of large
  1587.              application programs, and the capabilities of advanced CPUs,
  1588.              there are many different kinds of memory.  The original 8088
  1589.              CPUs of the PC and PC/XT can address 1 MByte of memory.  Of
  1590.              that, a maximum of 640KBytes is allocated as base,
  1591.              conventional, DOS, or low DOS memory (all these terms mean the
  1592.              same thing).  The other 384 KBytes, known as upper memory, are
  1593.              set aside for the computer's built-in ROM BIOS, video adapter
  1594.              cards, hard disk controllers, and other expansion hardware.
  1595.  
  1596.              When base memory became too limiting, expanded memory (or EMS
  1597.              memory) was developed to give programs more data space.
  1598.              Expanded memory adds a maximum of 16 MBytes which programs can
  1599.              access, 64KBytes at a time, through a window in upper memory.
  1600.              In 8088 / 8086 (PC and XT), and 80286 (AT) based computers,
  1601.              expanded memory typically requires an add-on board and support
  1602.              software.  In 386, 486, and Pentium computers, expanded memory
  1603.  
  1604.  
  1605.  
  1606.         -------------------------------------------------------------------
  1607.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 24
  1608.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1609.         -------------------------------------------------------------------
  1610.  
  1611.  
  1612.              is typically provided without additional hardware, using the
  1613.              capabilities of the 386 / 486 / Pentium chips.
  1614.  
  1615.              The 80286 CPU used in the AT, and modern 386, 486, and Pentium
  1616.              CPUs, can use much more than the 8088's original 1 MByte of
  1617.              memory.  An 80286 can use a total of 16 MBytes, and the 386,
  1618.              486, and Pentium can use up to 4,096 MBytes (4 gigabytes) of
  1619.              physical memory.  This extended memory is not normally
  1620.              available to DOS-based programs, however, without special
  1621.              programming techniques and the help of DOS extenders or memory
  1622.              managers.
  1623.  
  1624.              The memory terms used in your 4DOS manuals include:
  1625.  
  1626.                   Base memory:  The 640 Kbytes or less that has
  1627.                   traditionally been available for DOS and DOS-based
  1628.                   applications.
  1629.  
  1630.                   EMS or LIM EMS Memory:  Memory which conforms to the
  1631.                   Expanded Memory Specification, developed by Lotus, Intel,
  1632.                   and Microsoft, that lets programs and utilities share
  1633.                   expanded memory.
  1634.  
  1635.                   Extended Memory:  Memory beyond 1 MB in 80286, 386, 486
  1636.                   and Pentium computers.  This memory may be accessed
  1637.                   directly, in which case it is referred to as Extended
  1638.                   Memory, or through XMS software, in which case it is
  1639.                   referred to as XMS Memory.
  1640.  
  1641.                   XMS Memory:  Extended memory managed by software which
  1642.                   conforms to the Extended Memory Specification (XMS).  XMS
  1643.                   lets programs share extended memory without conflict.
  1644.                   This specification divides extended memory into extended
  1645.                   memory blocks (EMBs).  XMS software also usually manages
  1646.                   the HMA and the UMBs.
  1647.  
  1648.                   HMA:  The first 64K bytes of extended memory, located
  1649.                   just above 1 MB.  Certain specialized programs such as
  1650.                   DESQview, some network drivers, and portions of MS-DOS
  1651.                   (version 5.0 or later) and Novell DOS (version 5.0 or
  1652.                   later) can be loaded into the HMA instead of taking up
  1653.                   valuable space in base memory.
  1654.  
  1655.                   UMBs:  386, 486, and Pentium computers can electronically
  1656.                   "move" pieces of extended memory into unused space in the
  1657.                   upper memory area between 640KB and 1 MB.  Each block of
  1658.                   this memory is called an Upper Memory Block (UMB).  With
  1659.                   MS-DOS / PC-DOS 5.0 or later, Novell DOS 5.0 or later, or
  1660.                   third-party memory managers like 386MAX and QEMM, memory-
  1661.                   resident programs can be loaded into these UMBs instead
  1662.  
  1663.  
  1664.         -------------------------------------------------------------------
  1665.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 25
  1666.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1667.         -------------------------------------------------------------------
  1668.  
  1669.  
  1670.                   of taking up valuable space in base memory.  Some 8086,
  1671.                   8088, and 80286 systems can also use UMBs with
  1672.                   appropriate additional hardware and software.
  1673.  
  1674.              4DOS does its best to detect and properly access all types of
  1675.              memory that your computer can have.  4DOS always uses
  1676.              standard, documented methods to use the memory that you have
  1677.              installed.
  1678.  
  1679.              4DOS uses memory in three ways (see page 18 for more
  1680.              information about swapping and the resident and transient
  1681.              portions of 4DOS):
  1682.  
  1683.                   * By default, 4DOS uses base memory for its resident
  1684.                     portion, the master environment, and the alias and
  1685.                     history lists.  Base memory is also used to hold the
  1686.                     transient portion of 4DOS while your system is at the
  1687.                     command prompt or executing a 4DOS command or batch
  1688.                     file, and to create any necessary temporary data areas
  1689.                     (for example, to hold the filenames to be listed in a
  1690.                     directory display, or data being copied from one file
  1691.                     to another).
  1692.  
  1693.                   * 4DOS can use EMS memory or an XMS Extended Memory
  1694.                     Block (EMB) to swap its transient portion, according
  1695.                     to the Swapping directive in your 4DOS.INI file.
  1696.  
  1697.                   * 4DOS can use Upper Memory Blocks (UMBs) for its
  1698.                     resident portion, master environment, and global alias
  1699.                     and history lists.
  1700.  
  1701.              4DOS never accesses extended memory directly.  It always uses
  1702.              an XMS driver like HIMEM.SYS, 386MAX, QEXT, or QEMM.  4DOS can
  1703.              also access any RAM disk you create in extended memory by
  1704.              using a program like VDISK.SYS or RAMDRIVE.SYS.  4DOS does not
  1705.              use the HMA at all.
  1706.  
  1707.              If you want to know whether 4DOS sees your system's memory
  1708.              accurately, check the output of the MEMORY command.  It should
  1709.              correspond to your computer's memory configuration.
  1710.  
  1711.              The MEMORY command's output depends to some extent on your
  1712.              memory manager.  Some memory managers turn your extended
  1713.              memory into either XMS or EMS memory as required, so that the
  1714.              same memory is shown both ways in the MEMORY report.  If 1 MB
  1715.              of extended memory managed by such a memory manager is
  1716.              available, MEMORY will report 1 MB of free XMS memory and 1 MB
  1717.              of free EMS memory, even though it is all the same memory.
  1718.  
  1719.  
  1720.  
  1721.  
  1722.         -------------------------------------------------------------------
  1723.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 26
  1724.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1725.         -------------------------------------------------------------------
  1726.  
  1727.  
  1728.              Memory-related problems with 4DOS are usually due to programs
  1729.              which overwrite the extended memory block (EMB) that 4DOS uses
  1730.              for swapping its transient portion.  When you exit from such a
  1731.              program, your system will hang, because 4DOS tried to swap
  1732.              itself back into base memory but its code and data in XMS have
  1733.              been destroyed by the program.  The same problem can occur
  1734.              with EMS swapping but is less common because EMS memory is
  1735.              generally better defended against wayward programs.  You can
  1736.              diagnose this kind of problem easily by changing to disk
  1737.              swapping with the 4DOS.INI Swapping directive (see page 18)
  1738.              and rebooting.  If the problem goes away with disk swapping,
  1739.              then the program in question is probably destroying 4DOS's
  1740.              swap area in XMS or EMS memory.
  1741.  
  1742.              4DOS EMS swapping sometimes has difficulty with EMS drivers
  1743.              which do not fully meet the EMS 3.2 specification (4DOS
  1744.              supports, but does not require, EMS 4.0 drivers).  If you have
  1745.              trouble accessing EMS for swapping, check APPNOTES.DOC to see
  1746.              if there are any known problems with your EMS board or the
  1747.              associated driver software.
  1748.  
  1749.  
  1750.              Upper Memory Blocks (UMBs)
  1751.  
  1752.              4DOS uses UMBs for several purposes:
  1753.  
  1754.                   * to move the 4DOS resident portion out of base memory,
  1755.                     if you specify UMBLoad = Yes in your 4DOS.INI file.
  1756.  
  1757.                   * to move the master environment out of base memory, if
  1758.                     you specify UMBEnvironment = Yes in your 4DOS.INI
  1759.                     file.
  1760.  
  1761.                   * to move the global alias and history lists out of base
  1762.                     memory, if you specify UMBAlias = Yes or UMBHistory =
  1763.                     Yes in your 4DOS.INI file.
  1764.  
  1765.                   * to load memory-resident programs (TSRs) "high" using
  1766.                     the LOADHIGH or LH command under MS-DOS / PC-DOS 5.0
  1767.                     or above or Novell DOS 5.0 or above, or in an OS/2 DOS
  1768.                     session.
  1769.  
  1770.              To load 4DOS, the master environment, or global alias and
  1771.              history lists into a UMB, you must be using a memory manager
  1772.              or XMS driver which provides both the ability to remap memory
  1773.              into the area between 640K and 1MB (to create the UMBs) and
  1774.              XMS or DOS 5.0 UMB support (to manage the UMBs).  These are
  1775.              generally the same requirements which must be met to load TSRs
  1776.              "high."
  1777.  
  1778.  
  1779.  
  1780.         -------------------------------------------------------------------
  1781.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 27
  1782.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1783.         -------------------------------------------------------------------
  1784.  
  1785.  
  1786.              To give 4DOS access to UMBs, you need hardware and software
  1787.              combinations like the following:
  1788.  
  1789.              386, 486, and Pentium systems (including 386SX computers):
  1790.  
  1791.                   Hardware:  Sufficient installed RAM.
  1792.  
  1793.                   Software:  Qualitas' 386MAX or Blue Max, Quarterdeck's
  1794.                   QEMM 5.0 or later, DOS's EMM386.SYS, or a similar 386
  1795.                   memory manager.  HIMEM.SYS alone is not sufficient.
  1796.  
  1797.              80286 systems:
  1798.  
  1799.                   Hardware:  Chips and Technologies NEAT or LEAP chip set,
  1800.                   or an EMS 4.0 or EEMS memory board, plus sufficient
  1801.                   installed RAM.
  1802.  
  1803.                   Software:  Qualitas' MOVE-EM 1.02 or later with
  1804.                   Microsoft's HIMEM.SYS, Quarterdeck's QRAM and QEXT, or a
  1805.                   similar 286 memory manager.
  1806.  
  1807.  
  1808.              Upper Memory Regions
  1809.  
  1810.              Upper memory blocks are divided into one or more contiguous
  1811.              regions by your memory manager (see your memory manager
  1812.              documentation for additional details).  All the 4DOS options
  1813.              and commands which allow access to UMBs also allow you to
  1814.              specify a particular UMB region.  For example, you can load
  1815.              the resident portion of 4DOS into upper memory region 1 with a
  1816.              UMBLoad = 1 directive in 4DOS.INI.  If you do not specify a
  1817.              particular region (for example, if you use UMBLoad = Yes
  1818.              rather than UMBLoad = 1), 4DOS will use the first available
  1819.              region.
  1820.  
  1821.              In order to use specific region numbers, you must enable DOS
  1822.              UMB management with the DOS=UMB or DOS=HIGH,UMB directive in
  1823.              CONFIG.SYS, or with the DOS_UMB setting for OS/2 2.x DOS
  1824.              sessions.  If you do not, 4DOS will display an error message
  1825.              and ignore the region number.
  1826.  
  1827.              You can make region support available by using DOS=UMB or
  1828.              DOS=HIGH,UMB even if you are using a 3rd-party memory manager
  1829.              like 386MAX or QEMM.  However, enabling DOS UMB management
  1830.              will disable the "load high" programs that come with some
  1831.              memory managers, requiring you to use the DOS DEVICEHIGH and
  1832.              4DOS LOADHIGH commands instead.  For additional details on how
  1833.              your memory manager responds to DOS UMB management, see the
  1834.              memory manager documentation.
  1835.  
  1836.  
  1837.  
  1838.         -------------------------------------------------------------------
  1839.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 28
  1840.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1841.         -------------------------------------------------------------------
  1842.  
  1843.  
  1844.              Region number support is not available under Novell DOS.
  1845.  
  1846.  
  1847.         Video
  1848.  
  1849.              Although 4DOS can normally detect your video parameters
  1850.              automatically, you may have to configure it to use the system
  1851.              most efficiently.
  1852.  
  1853.              4DOS uses two methods of displaying text on the screen:
  1854.  
  1855.                   * 4DOS calls DOS to write the text of prompts and normal
  1856.                     messages.  If you use an ANSI driver, DOS will
  1857.                     transmit the calls to it.  Otherwise, DOS will use
  1858.                     your BIOS to display text on the screen.  DOS text
  1859.                     display calls will work on all DOS systems, regardless
  1860.                     of video type.
  1861.  
  1862.                   * The DRAWBOX, DRAWHLINE, DRAWVLINE, LIST, SELECT,
  1863.                     SCRPUT, and VSCRPUT commands bypass DOS, the BIOS, and
  1864.                     any ANSI driver.  They write directly to video memory.
  1865.                     These commands will only work on systems with 100%
  1866.                     IBM-compatible video systems.  On other computers,
  1867.                     results will be unpredictable at best.  If you
  1868.                     experience a problem, try adding the line OutputBIOS =
  1869.                     Yes to your 4DOS.INI file.
  1870.  
  1871.              EGA and VGA systems can display text in standard 25-line mode,
  1872.              plus modes with 43, 50, or more lines.  4DOS normally detects
  1873.              the number of lines automatically.  If it doesn't, you can use
  1874.              the 4DOS.INI ScreenRows directive or the SETDOS /R command to
  1875.              set the 4DOS screen length.  Similarly, 4DOS normally detects
  1876.              the width of your screen, but in rare cases with some unusual
  1877.              video boards you may need to use the ScreenColumns directive
  1878.              to set the number of columns explicitly.
  1879.  
  1880.              4DOS never attempts to manipulate your video hardware in order
  1881.              to set the number of rows or columns actually displayed on the
  1882.              screen (the "video mode"); to do so, you must use the software
  1883.              that came with your video board or other software tailored to
  1884.              your system.
  1885.  
  1886.              If you put the screen in 43-line or 50-line mode and find that
  1887.              it still scrolls at the 25th line, you probably have installed
  1888.              an ANSI driver which does not support your extended screen
  1889.              length.  In this case you may need to use a different ANSI
  1890.              driver.
  1891.  
  1892.              The video cursor shape that 4DOS uses is defined as a
  1893.              percentage of a character cell height.  You can set the height
  1894.  
  1895.  
  1896.         -------------------------------------------------------------------
  1897.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 29
  1898.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1899.         -------------------------------------------------------------------
  1900.  
  1901.  
  1902.              independently for insert and overstrike mode with the
  1903.              CursorIns and CursorOver directives in 4DOS.INI or with the
  1904.              SETDOS /S command.  If you don't use either, 4DOS sets the
  1905.              height to 10% of the character cell height for overstrike mode
  1906.              and 100% (a block cursor) for insert mode.
  1907.  
  1908.              If the cursor does not appear the way you want it to, use
  1909.              SETDOS /S to find the values that work for your system.  Some
  1910.              video boards may not give a "smooth" response to varying
  1911.              SETDOS /S values.  For example, a value of 20% may generate a
  1912.              very small cursor while a value of 30% may generate a half-
  1913.              height cursor.  4DOS can't do anything about this behavior, so
  1914.              you will have to experiment to find the cursor values that you
  1915.              want to use.
  1916.  
  1917.              If you are using an EGA or VGA adapter, we encourage you to
  1918.              try UltraVision from Personics Corp.  It gives you excellent
  1919.              control over your video system, includes a wide variety of
  1920.              text-mode screen fonts, has its own ANSI driver, and works
  1921.              superbly with 4DOS.  A special version for laptop and notebook
  1922.              computers dramatically improves the readability of their
  1923.              smaller displays.
  1924.  
  1925.              Most versions of DOS include a copy of ANSI.SYS, a device
  1926.              driver that is normally installed with a DEVICE= line in your
  1927.              CONFIG.SYS file.  There are a number of more powerful and
  1928.              faster versions available as public-domain, shareware, and
  1929.              retail products.  PC Magazine's free utility ANSI.COM can be
  1930.              enabled, disabled, loaded, and unloaded without rebooting, and
  1931.              works well inside windows of multitasking systems.  It is
  1932.              available on most bulletin boards and online systems.  Another
  1933.              excellent choice is ANSI-UV.SYS which is included with
  1934.              UltraVision.
  1935.  
  1936.              4DOS normally detects automatically whether an ANSI driver is
  1937.              installed.  If you have an ANSI driver installed and 4DOS
  1938.              doesn't recognize it, try the command SETDOS /A1 which forces
  1939.              4DOS to use ANSI commands.  Use SETDOS /A2 to tell 4DOS you do
  1940.              not have an ANSI driver installed.  These options can also be
  1941.              set with the ANSI directive in 4DOS.INI.
  1942.  
  1943.              If you have a laptop or notebook computer with a color video
  1944.              board and a monochrome screen, you may need to add a
  1945.              HelpOptions=/M directive to 4DOS.INI, or run HELPCFG to adjust
  1946.              the HELP colors.  (See page 21 for additional information on
  1947.              help colors.)
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.         -------------------------------------------------------------------
  1955.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 30
  1956.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  1957.         -------------------------------------------------------------------
  1958.  
  1959.  
  1960.         Hard Drives and Floppy Disks
  1961.  
  1962.              4DOS uses your disks for a wide variety of purposes, and many
  1963.              4DOS commands are designed to help you create, move, delete,
  1964.              view, and otherwise manage disk files.  4DOS never tries to
  1965.              manipulate the structure of your hard disk directly.  It never
  1966.              modifies the FAT, root directory, or other system areas of the
  1967.              disk directly, and it doesn't read or write data on your disk
  1968.              itself.  It always calls on DOS to perform these actions, just
  1969.              like most application programs do.  As a result, 4DOS is
  1970.              compatible with all disk sizes, formats, and structures that
  1971.              your DOS version supports.
  1972.  
  1973.              4DOS is also fully compatible with hard disk compression
  1974.              software like DBLSPACE, Stacker, and SuperStor.  Under some
  1975.              compression systems you can display file compression ratios
  1976.              and sort directory displays in compression ratio order using
  1977.              the /C and /O:c switches of the DIR and SELECT commands.  See
  1978.              APPNOTES.DOC for details on using your particular compression
  1979.              software with 4DOS.
  1980.  
  1981.              4DOS will generally access your disk very quickly, but the
  1982.              speed depends on what you are trying to do.  If you find that
  1983.              4DOS is slower at performing a particular function than you
  1984.              are used to, you may have asked it to do more than you ask of
  1985.              traditional DOS commands.  In particular, if you use file
  1986.              descriptions, remember that 4DOS has to access the description
  1987.              file as well as the actual files that you are manipulating.
  1988.  
  1989.              Some users notice that the common commands DEL and DIR appear
  1990.              slower with 4DOS under certain circumstances.  With DEL, this
  1991.              slowdown may be because 4DOS uses a newer method of file
  1992.              deletion instead of a method that is no longer recommended
  1993.              (but is still used by COMMAND.COM).  The new method is
  1994.              necessary to enable 4DOS's display of the names of the files
  1995.              you are deleting, and to support 4DOS's "extended wildcards."
  1996.              You can force 4DOS to use the older method with DEL's /Q
  1997.              option, as long as you don't use extended wildcards.
  1998.  
  1999.              For DIR, any speed decrease is because of 4DOS's directory
  2000.              sorting and description processing.  4DOS must read all
  2001.              filenames and descriptions before it can display any of them.
  2002.              The sort itself is quite fast, but DOS is relatively slow at
  2003.              retrieving the entire list of file names and passing them on
  2004.              to 4DOS.  Once the 4DOS DIR display starts, it should go as
  2005.              fast as or faster than the traditional DIR display.
  2006.  
  2007.              Whenever 4DOS is interrupted by a Ctrl-C or Ctrl-Break, it
  2008.              performs a "disk reset" to clear out DOS's disk buffers and
  2009.              reset internal DOS disk parameters.  This helps ensure that
  2010.  
  2011.  
  2012.         -------------------------------------------------------------------
  2013.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 31
  2014.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2015.         -------------------------------------------------------------------
  2016.  
  2017.  
  2018.              modified data has been written to disk even though the
  2019.              operation was interrupted.  A disk reset is also performed
  2020.              before a REBOOT command.  If you have trouble with recognition
  2021.              of floppy disk changes, with CD-ROM drivers, or with network
  2022.              disk access, you can try forcing 4DOS to perform a disk reset
  2023.              after file processing commands, and before a DIR.  To do so
  2024.              use a DiskReset = Yes directive in 4DOS.INI.  Such problems
  2025.              are very rare and normally DiskReset = Yes is not necessary.
  2026.  
  2027.  
  2028.         4DOS and DOS
  2029.  
  2030.              4DOS is compatible with all versions of MS-DOS and PC-DOS from
  2031.              2.0 through 6.2 and above.  We recommend the use of DOS 3.1 or
  2032.              above.
  2033.  
  2034.              If you use the MS-DOS utility APPEND, you may need to set up
  2035.              some aliases to invoke it; see APPNOTES.DOC for details.
  2036.  
  2037.              If you use the FORMAT /S command from MS-DOS or PC-DOS,
  2038.              version 4.0 or above, FORMAT will copy the file pointed to by
  2039.              the COMSPEC environment variable (see page 17) and name it
  2040.              COMMAND.COM.  In most cases this means that 4DOS.COM will be
  2041.              copied to the floppy disk, but with the name COMMAND.COM.
  2042.              Such a disk should boot properly and start 4DOS, but its
  2043.              contents are sure to be confusing to others.  If you use
  2044.              FORMAT /S with MS-DOS or PC-DOS 4.0 or above, we recommend
  2045.              that you copy COMMAND.COM manually to the floppy disk (you can
  2046.              use an alias or batch file if you format bootable disks
  2047.              frequently), or rename the file that FORMAT copies back to
  2048.              4DOS.COM and place a proper CONFIG.SYS file for 4DOS on the
  2049.              floppy disk.
  2050.  
  2051.  
  2052.              Menus and SET Commands in CONFIG.SYS
  2053.  
  2054.              MS-DOS and PC-DOS 6.0 and above support configuration menus in
  2055.              CONFIG.SYS.  If you use these menus, the menu choice you make
  2056.              is typically stored in an environment variable.  In addition,
  2057.              under MS-DOS and PC-DOS 6.0 and above, and under Novell DOS,
  2058.              you can put SET commands in CONFIG.SYS to set environment
  2059.              variables explicitly.
  2060.  
  2061.              4DOS will automatically retrieve environment variables created
  2062.              in CONFIG.SYS and store them in the environment for use in
  2063.              AUTOEXEC.BAT and other batch files, just as COMMAND.COM does.
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.         -------------------------------------------------------------------
  2071.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 32
  2072.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2073.         -------------------------------------------------------------------
  2074.  
  2075.  
  2076.              Novell DOS / DR DOS
  2077.  
  2078.              (This section covers Novell DOS, as well as the older version
  2079.              of the same product, called DR DOS.  Throughout this section,
  2080.              and the rest of the manual, we refer to the product by its
  2081.              newer name, Novell DOS.  Unless otherwise noted, all
  2082.              information below applies to both the older DR DOS and the
  2083.              newer Novell DOS.)
  2084.  
  2085.              4DOS will work properly as the command processor for Novell
  2086.              DOS 3.4 through 7.0 and above.  However, there are certain
  2087.              differences between Novell DOS and MS-DOS which may affect
  2088.              4DOS.  This section covers some of those differences; see
  2089.              APPNOTES.DOC for additional information, including details on
  2090.              using the Novell DOS task switcher, TaskMax, with 4DOS.
  2091.  
  2092.  
  2093.              HILOAD
  2094.  
  2095.              4DOS supports the HILOAD feature using the MS-DOS / PC-DOS
  2096.              command names of LOADHIGH or LH.  To load a TSR high simply
  2097.              use the command:
  2098.  
  2099.                   LH program [options]
  2100.  
  2101.              If you want the command to be called HILOAD for complete
  2102.              Novell DOS compatibility, set up an alias before using it:
  2103.  
  2104.                   alias hiload lh
  2105.  
  2106.              Just as under MS-DOS, LOADHIGH and LH will not work properly
  2107.              unless you have memory management software loaded to provide
  2108.              upper memory block support.  Because Novell DOS does not
  2109.              return any error to 4DOS if a LOADHIGH operation fails, 4DOS
  2110.              cannot report this condition to you.  This means you must use
  2111.              the Novell DOS MEM program or another similar memory mapping
  2112.              utility to determine if your TSR was actually loaded high.
  2113.  
  2114.              The LOADHIGH command's /L and /S switches are included for
  2115.              compatibility with MS-DOS / PC-DOS 6.0 and above, and will not
  2116.              work with Novell DOS.
  2117.  
  2118.  
  2119.              File Passwords
  2120.  
  2121.              4DOS includes support for Novell DOS file passwords.  However,
  2122.              the command syntax used to access files with passwords is
  2123.              slightly different under 4DOS than under Novell DOS
  2124.              COMMAND.COM.
  2125.  
  2126.  
  2127.  
  2128.         -------------------------------------------------------------------
  2129.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 33
  2130.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2131.         -------------------------------------------------------------------
  2132.  
  2133.  
  2134.              The character used to separate passwords from filenames under
  2135.              Novell DOS is a semicolon [;], which 4DOS uses to separate
  2136.              parts of an "include list".  Therefore, to avoid confusion
  2137.              with include lists, 4DOS requires the use of two semicolons to
  2138.              separate the password and filename in any command which
  2139.              supports wildcards.  For example, to delete the file MYDATA
  2140.              which has the password "fred", you would use these commands:
  2141.  
  2142.                   del mydata;fred          for COMMAND.COM
  2143.                   del mydate;;fred         for 4DOS
  2144.  
  2145.              4DOS directory-related commands like MD and CD (or MKDIR and
  2146.              CHDIR) do not use wildcards.  Those commands, and Novell DOS
  2147.              external commands which accept the "filename;password" syntax,
  2148.              use only a single semicolon.
  2149.  
  2150.              Novell DOS hides files which are password-protected.  This
  2151.              means that you must use 4DOS command switches which allow
  2152.              processing of hidden files (COPY /H, DEL /Z, DIR /A, FOR /A,
  2153.              MOVE /H, and SELECT /A) to access a password-protected file
  2154.              under Novell DOS.
  2155.  
  2156.              Passwords are not automatically preserved when copying or
  2157.              moving a file with 4DOS.  However, the hidden attribute will
  2158.              be preserved.  This means that if you move or copy a password-
  2159.              protected file and want it to be visible in its new location
  2160.              or under its new name, you will have to manually remove the
  2161.              hidden attribute with ATTRIB.
  2162.  
  2163.              For example, to password-protect the file MYDATA, copy it to
  2164.              drive A:, and then delete it:
  2165.  
  2166.                   c:\> password mydata /r:fred
  2167.                   c:\> copy /h mydata;;fred a:
  2168.                   c:\> del /z mydata;;fred
  2169.  
  2170.              To unprotect the password-protected file MYDATA:
  2171.  
  2172.                   c:\> password mydata;fred /n
  2173.  
  2174.  
  2175.         Using 4DOS with Task Switchers and Multitaskers
  2176.  
  2177.              Task switchers are programs that allow you to switch quickly
  2178.              among multiple applications, with one application running at a
  2179.              time.  Multitaskers are more complex programs which appear to
  2180.              run multiple applications at the same time, with one or more
  2181.              programs executing "in the background" while you work with
  2182.              another program on the screen.
  2183.  
  2184.  
  2185.  
  2186.         -------------------------------------------------------------------
  2187.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 34
  2188.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2189.         -------------------------------------------------------------------
  2190.  
  2191.  
  2192.              This section gives you some important general tips on using
  2193.              4DOS with task switchers and multitaskers, and includes a
  2194.              specific discussion of Microsoft Windows.  If you are using
  2195.              DESQview, see APPNOTES.DOC for additional information.  See
  2196.              page 42 for a complete discussion on using 4DOS under OS/2.
  2197.  
  2198.              For convenience, in the text below we will refer to both
  2199.              multitaskers and task switchers as "multitaskers," and to each
  2200.              window or partition they use as a "window," even though some
  2201.              do not have windowed displays.
  2202.  
  2203.              4DOS works well as both the primary shell (loaded when your
  2204.              system boots) and the secondary shell (loaded in a window)
  2205.              with most multitaskers.  (See Chapter 1 of your Reference
  2206.              Manual for more information about primary and secondary
  2207.              shells.)
  2208.  
  2209.  
  2210.              Creating a 4DOS Window
  2211.  
  2212.              Most multitaskers have a pre-configured "DOS" window.  In some
  2213.              cases, this window always runs COMMAND.COM.  In others, it
  2214.              runs the default command processor defined when your system
  2215.              boots.  We recommend that you always set up a 4DOS window
  2216.              explicitly, with the configuration you want, rather that
  2217.              relying on the multitasker's generic "DOS" window.
  2218.  
  2219.              Many multitaskers also run the command processor when you
  2220.              start certain kinds of windows, such as windows that run a
  2221.              .BAT file.  In general, this use of the command processor is
  2222.              transparent.  The multitasker will run 4DOS for you
  2223.              automatically when it needs to, and you won't need to do
  2224.              anything about it.
  2225.  
  2226.              If you find that your multitasker is running COMMAND.COM when
  2227.              you meant to run 4DOS, check the COMSPEC setting that is in
  2228.              effect when you start the multitasker (see page 17 for details
  2229.              on COMSPEC).  You may also need to check the way a particular
  2230.              window is configured.
  2231.  
  2232.              When you set up a 4DOS window, be sure to specify the full
  2233.              path to 4DOS.COM and any startup options you want (see page 15
  2234.              for information on startup options for secondary shells).
  2235.  
  2236.  
  2237.              Parameters for 4DOS Windows
  2238.  
  2239.              To set parameters (swapping, alias space, etc.) to be used by
  2240.              all 4DOS secondary shells run by your multitasker, use the
  2241.              [Secondary] section in 4DOS.INI.  To set these parameters
  2242.  
  2243.  
  2244.         -------------------------------------------------------------------
  2245.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 35
  2246.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2247.         -------------------------------------------------------------------
  2248.  
  2249.  
  2250.              separately for a specific window, create a copy of 4DOS.INI
  2251.              just for that window and use the @d:\path\inifile option on
  2252.              your command line for the window (see page 11).  To change the
  2253.              configuration of a specific window without creating a separate
  2254.              copy of 4DOS.INI, use the //iniline option on your command
  2255.              line for the window (see the example below).
  2256.  
  2257.              4DOS allows you to place a command to be executed as the last
  2258.              parameter on your 4DOS command line.  This command is executed
  2259.              before 4DOS displays its first prompt.  You can use this
  2260.              feature to run a batch file (or any other command) each time a
  2261.              4DOS window is started by your multitasker.  For example, if
  2262.              you are setting up 4DOS to run as a DOS application under
  2263.              Windows 3.1, your setup for a 4DOS program item (or in a .PIF
  2264.              file for 4DOS) might look like this:
  2265.  
  2266.                   Program Name:  c:\4dos\4dos.com
  2267.                   Parameters:    //swapping=f:\ c:\winstart.btm
  2268.  
  2269.              This tells Windows to load 4DOS, includes a 4DOS.INI directive
  2270.              to tell 4DOS to swap to drive F, and passes 4DOS the command
  2271.              C:\WINSTART.BTM.  You can place commands in WINSTART.BTM to be
  2272.              executed whenever such a window is started (for example, to
  2273.              change your PROMPT to show that you're in a window, or to load
  2274.              a TSR for just that window).  The command to be executed
  2275.              (C:\WINSTART.BTM in this example), must be the last thing on
  2276.              the 4DOS command line; no 4DOS switches or options can be
  2277.              placed after it because anything after the command will be
  2278.              interpreted as parameters for the command.
  2279.  
  2280.              This feature is similar to what's provided by the 4START batch
  2281.              file, but 4START is executed every time 4DOS loads, whereas a
  2282.              file like WINSTART will be executed only when a 4DOS window is
  2283.              started from your multitasker.  A batch file started this way
  2284.              will be run after 4START.
  2285.  
  2286.          ##  If you wish, you can use 4START to accomplish the same goal.
  2287.              However, in order to do so you must have a way to detect
  2288.              whether the multitasker is running, so that you can select the
  2289.              appropriate commands to execute in 4START.  If you are running
  2290.              DESQview or Windows, you can use the 4DOS internal variables
  2291.              _DV and _WIN respectively to test this condition.  For
  2292.              example, the following lines could be used in 4START to change
  2293.              the prompt for DESQview command-line sessions:
  2294.  
  2295.                   iff "%_DV" != "0"
  2296.                      prompt [DV] $p$g
  2297.                   else
  2298.                      prompt $p$g
  2299.                   endiff
  2300.  
  2301.  
  2302.         -------------------------------------------------------------------
  2303.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 36
  2304.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2305.         -------------------------------------------------------------------
  2306.  
  2307.  
  2308.           ## Multitasking and KEYSTACK
  2309.  
  2310.              If you use KEYSTACK inside a window of a multitasker, and the
  2311.              KSTACK.COM program has been loaded before the multitasker, you
  2312.              may find that stacked keystrokes "bleed through" from one
  2313.              window to another.  You can solve this problem by loading
  2314.              KSTACK.COM in a startup batch file for each window where it is
  2315.              needed.  If KSTACK is loaded before the multitasker as well,
  2316.              include a /I on the command line when loading KSTACK inside
  2317.              the window.  If you don't, KSTACK will detect that it is
  2318.              already installed and will not install again.
  2319.  
  2320.  
  2321.          ## ! Multitasking and Disk Swapping
  2322.  
  2323.              When 4DOS is loaded as the primary shell, it acts as a
  2324.              "traffic cop" for copies of the transient portion of 4DOS
  2325.              swapped to disk.  Each secondary shell is assigned a unique
  2326.              shell number, which is normally used as the extension for its
  2327.              disk swap file name (4DOSSWAP.001, 4DOSSWAP.002, etc.).  These
  2328.              shell numbers avoid file name conflicts between multiple
  2329.              copies of 4DOS running in different windows but creating swap
  2330.              files in the same disk directory.
  2331.  
  2332.              However, if 4DOS is not loaded before the multitasker, this
  2333.              capability will not be available.  In this case, the copy of
  2334.              4DOS in each window will use a swap file called 4DOSSWAP.000.
  2335.              To avoid this conflict, you must either use the UniqueSwapName
  2336.              directive in 4DOS.INI, or force every copy of 4DOS to place
  2337.              its swap file in its own unique directory by using the
  2338.              "Swapping=d:\path" directive in 4DOS.INI.  If you don't follow
  2339.              this rule, your system will hang when you switch windows or
  2340.              when you exit from an application.
  2341.  
  2342.              This problem will occur only in those rare situations where
  2343.              4DOS is loaded within a window but is not loaded as your
  2344.              primary shell, and if 4DOS disk swapping is used in more than
  2345.              one window at a time.  Note that since the default swapping
  2346.              option uses disk swapping if insufficient EMS or XMS memory is
  2347.              available, you can be invoking disk swapping in your
  2348.              multitasker's windows without specifically requesting it.
  2349.  
  2350.  
  2351.              4DOS and Microsoft Windows
  2352.  
  2353.              4DOS works well as both the primary shell, loaded before
  2354.              Windows, and as a secondary shell loaded inside any window.
  2355.              It works in any Windows mode (Real, Standard, or Enhanced).
  2356.              The general information about multitaskers beginning on page
  2357.  
  2358.  
  2359.  
  2360.         -------------------------------------------------------------------
  2361.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 37
  2362.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2363.         -------------------------------------------------------------------
  2364.  
  2365.  
  2366.              34 applies to Windows as well.  You should read it before
  2367.              continuing with this section.
  2368.  
  2369.              This section gives you the basic information you need to use
  2370.              4DOS with Windows.  For additional details and updated
  2371.              information be sure to check APPNOTES.DOC.  All of the
  2372.              information in this section applies to both the standard
  2373.              single-user version of Windows and the peer-to-peer network
  2374.              version, Windows for Workgroups.
  2375.  
  2376.              To run 4DOS as a secondary shell from within Windows, you will
  2377.              need to create a desktop object for it.  The generic "MS-DOS
  2378.              Prompt" object supplied by Microsoft will normally run
  2379.              COMMAND.COM.
  2380.  
  2381.              You can set up a 4DOS object from the Program Manager's File /
  2382.              New menu selection.  To do so, simply create a new program
  2383.              item and set the command line to d:\path\4DOS.COM (use the
  2384.              appropriate drive and path for your system).  You can put the
  2385.              name of a batch file at the end of the command line if you
  2386.              want to run some specific commands when 4DOS starts under
  2387.              Windows (see page 36 for details).
  2388.  
  2389.              When you create a new item in this way, it will be initialized
  2390.              with a standard DOS icon (the word "DOS" inside a rectangle).
  2391.              To install a specific icon for 4DOS, use the Program Manager's
  2392.              File / Properties menu selection.  Click on the Change Icon
  2393.              button and type in the full path name of your new 4DOS icon
  2394.              file.  We supply two Windows icons with 4DOS:  4DOS.ICO for
  2395.              color displays, and 4DOSM.ICO for monochrome displays.  You
  2396.              can create your own icon with any icon editor.
  2397.  
  2398.              For more flexibility, you can use the Windows PIF editor to
  2399.              create a 4DOS.PIF file.  We have included a sample .PIF file
  2400.              on the distribution diskette.  You must edit this file and
  2401.              make it correspond to your system before you use it to run
  2402.              4DOS.
  2403.  
  2404.              4DOS will work properly in either a full-screen or a windowed
  2405.              session.  The .PIF file determines the mode that 4DOS will
  2406.              start in.  If you don't use a .PIF file, 4DOS will start in
  2407.              the mode set in the _DEFAULT.PIF file provided with Windows.
  2408.              You can set up multiple .PIF files if you need different
  2409.              session types (for example, one for windowed and one for full-
  2410.              screen sessions).
  2411.  
  2412.              Your batch files can determine whether they are running in a
  2413.              secondary shell under Windows, and the current Windows mode,
  2414.              with the 4DOS _WIN internal variable.
  2415.  
  2416.  
  2417.  
  2418.         -------------------------------------------------------------------
  2419.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 38
  2420.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2421.         -------------------------------------------------------------------
  2422.  
  2423.  
  2424.              You can easily set up the Windows File Manager to make .BTM
  2425.              files "executable."  Open your WIN.INI file with any editor
  2426.              and find the section labeled [extensions].  Add the following
  2427.              line to the end of the section:
  2428.  
  2429.                   btm=c:\4dos\4dos.com /c ^.btm
  2430.  
  2431.              (adjust this to show the proper path for 4DOS.COM on your
  2432.              system).  It is not possible to execute .BTM files from the
  2433.              Program Manager by modifying the Programs= setting in WIN.INI;
  2434.              if you try to do so, the system will hang when you attempt to
  2435.              actually invoke a .BTM file.
  2436.  
  2437.              For information on resolving memory allocation problems with
  2438.              Windows, see page 58.
  2439.  
  2440.  
  2441.         Using 4DOS on a Network
  2442.  
  2443.              4DOS works well with DOS-compatible networks.  This section
  2444.              will give you some tips on using 4DOS on a network, and on the
  2445.              proper locations for 4DOS files on a network.
  2446.  
  2447.              In general, you'll find that you can load and run your network
  2448.              software normally under 4DOS.  Network drives will be
  2449.              accessible as normal drives once the network is loaded, and
  2450.              files on the network will be accessible just as if they were
  2451.              on a local hard disk.
  2452.  
  2453.              Some networks support file and directory names beginning with
  2454.              a double backslash, or with a server name followed by a colon,
  2455.              to identify files by their location on the network.  4DOS
  2456.              detects such names and passes them through to the network
  2457.              unaltered, allowing the network software to process them
  2458.              properly.
  2459.  
  2460.              In rare situations, you may have trouble loading network
  2461.              software under 4DOS.  To the best of our knowledge, all DOS-
  2462.              compatible networks work with 4DOS.  If yours doesn't, our
  2463.              experience suggests that the most common cause is a network
  2464.              bug, an old version of your network software, or a conflict in
  2465.              the way 4DOS and your network are configured.  Most bugs have
  2466.              now been corrected by network vendors, and should not appear
  2467.              on your system.  If you have any questions about compatibility
  2468.              with your particular network, check for a listing in
  2469.              APPNOTES.DOC, and feel free to contact our technical support
  2470.              department for additional assistance.
  2471.  
  2472.              If you need to boot a diskless workstation from a network
  2473.              drive, you must have the network drive accessible at boot
  2474.  
  2475.  
  2476.         -------------------------------------------------------------------
  2477.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 39
  2478.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2479.         -------------------------------------------------------------------
  2480.  
  2481.  
  2482.              time.  If this condition is satisfied (so 4DOS can find its
  2483.              files on the network drives), the normal approach can be used
  2484.              to start 4DOS from the network.  You can also configure 4DOS
  2485.              so that it boots from the floppy disk image used to start your
  2486.              diskless workstation, then retrieves its files from the
  2487.              network.  For complete details on starting 4DOS on a diskless
  2488.              workstation under Novell Netware see APPNOTES.DOC.  The
  2489.              approach described there can generally be used for other
  2490.              networks as well.
  2491.  
  2492.              Some networks with large server disk drives (256 MB or more)
  2493.              may report total and free disk space values that are too small
  2494.              if the DIR command, the FREE command, or the @DISKFREE,
  2495.              @DISKTOTAL, or @DISKUSED variable functions are used on the
  2496.              server drive.  If this occurs, it is because DOS does not
  2497.              provide a way for the network software to return larger values
  2498.              to 4DOS.
  2499.  
  2500.          ## ! When you use 4DOS with your network software loaded you need
  2501.              to ensure that two users do not use the same directory
  2502.              simultaneously for secondary shell disk swap files.  If they
  2503.              do, the filenames (4DOSSWAP.001, etc.) will conflict and each
  2504.              user will write over the other's files, possibly causing one
  2505.              or both systems to hang.  In most cases you will find this is
  2506.              not a problem, because most network users swap 4DOS to XMS or
  2507.              EMS memory or a local hard disk.  However if you do swap to a
  2508.              network drive, you can prevent a conflict with the
  2509.              UniqueSwapName directive in 4DOS.INI, or by using the Swapping
  2510.              directive to assign each user's swap files to a different
  2511.              directory.  For this reason, 4DOS will automatically enable
  2512.              UniqueSwapName if it detects that you are swapping to a
  2513.              network drive.
  2514.  
  2515.  
  2516.              4DOS and Novell Netware
  2517.  
  2518.              This section gives you basic information for using 4DOS with
  2519.              Netware.  For additional details and updated information be
  2520.              sure to check APPNOTES.DOC.  The information below applies to
  2521.              Netware, but not to Novell's peer-to-peer networking software,
  2522.              Netware Lite.
  2523.  
  2524.              4DOS works well with Netware, and compatibility problems
  2525.              should be very rare.  Novell's newer NETX shells are more
  2526.              reliable than the older NET3 / NET4 / NET5.  We recommend that
  2527.              you use NETX with 4DOS whenever possible.
  2528.  
  2529.              4DOS includes a 4DOS.INI directive for Netware, NetwareNames.
  2530.              You must set NetwareNames = Yes on systems which load Netware
  2531.              to avoid problems with destroyed environment variables during
  2532.  
  2533.  
  2534.         -------------------------------------------------------------------
  2535.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 40
  2536.                             CHAPTER 3 / 4DOS AND YOUR HARDWARE AND SOFTWARE
  2537.         -------------------------------------------------------------------
  2538.  
  2539.  
  2540.              LOGIN.  Setting NetwareNames = Yes will increase the resident
  2541.              size of 4DOS by 112 bytes.
  2542.  
  2543.              Under Netware version 3 and above, 4DOS commands which scan a
  2544.              directory tree (e.g. COPY /S, DIR /S, GLOBAL, etc.) may stop
  2545.              without scanning the entire tree, and without displaying an
  2546.              error message.  This happens when such commands exceed the
  2547.              size of the directory search table on your server; this is a
  2548.              Netware design issue and not a 4DOS bug.  You can fix this
  2549.              problem by having your system administrator increase the
  2550.              Maximum Oustanding NCP Searches parameter for the server in
  2551.              question.
  2552.  
  2553.              4DOS can be set up to run on Novell Netware diskless
  2554.              workstations which boot from the server.  To do so, you must
  2555.              make several changes to 4DOS.INI and your other startup files.
  2556.              See APPNOTES.DOC for complete details.
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.         -------------------------------------------------------------------
  2593.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 41
  2594.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  2595.         -------------------------------------------------------------------
  2596.  
  2597.  
  2598.  
  2599.         CHAPTER 4 / USING 4DOS UNDER OS/2
  2600.  
  2601.  
  2602.         4DOS offers almost unlimited flexibility for your OS/2 DOS
  2603.         sessions, and has been specifically designed to take advantage of
  2604.         OS/2 features wherever possible.  However, to use DOS, 4DOS, and
  2605.         OS/2 successfully requires some planning if you want to get all the
  2606.         power possible out of each operating environment.
  2607.  
  2608.         This chapter explains some of the planning you should do and some
  2609.         of the techniques you can use to get everything working together
  2610.         correctly.  It covers:
  2611.  
  2612.              * Configuring OS/2 version 1.x for 4DOS (see page 43).
  2613.  
  2614.              * Configuring OS/2 version 2.x DOS sessions (Virtual DOS
  2615.                Machines) for 4DOS (see page 43).
  2616.  
  2617.              * Arranging your 4DOS.INI, 4START, 4EXIT, and AUTOEXEC.BAT
  2618.                files for use in the multiple DOS sessions available under
  2619.                OS/2 2.x (see page 47).
  2620.  
  2621.              * Setting up temporary DOS sessions in OS/2 2.x to run a
  2622.                single DOS command or application (see page 48).
  2623.  
  2624.              * Adjusting 4DOS.INI, 4START, 4EXIT, and AUTOEXEC.BAT when
  2625.                you can boot under either DOS or OS/2 using OS/2's Dual
  2626.                Boot or Boot Manager features (see page 49).
  2627.  
  2628.         Throughout this section, we assume that you want to use 4DOS as
  2629.         your command processor in all of these situations.  Also, we assume
  2630.         that you have installed 4DOS in the C:\4DOS directory (alter the
  2631.         SHELL= and DOS_SHELL settings below appropriately if 4DOS is
  2632.         installed in a different directory).
  2633.  
  2634.         If you are using OS/2's Dual Boot or Boot Manager, you will have
  2635.         (at least) two copies of CONFIG.SYS and AUTOEXEC.BAT on your
  2636.         computer, one for booting OS/2 and OS/2 DOS sessions, and the other
  2637.         for booting DOS without OS/2.  See the section on Dual Boot and
  2638.         Boot Manager on page 49 for details on where these two sets of
  2639.         files are stored.  Unless otherwise specified, references in this
  2640.         section to CONFIG.SYS and AUTOEXEC.BAT refer to the OS/2 versions
  2641.         of these files.
  2642.  
  2643.         Before you read this section, read through Chapter 1 / Installation
  2644.         (see page 4) for details on installing 4DOS and modifying the
  2645.         SHELL= statement in your OS/2 CONFIG.SYS file.
  2646.  
  2647.  
  2648.  
  2649.  
  2650.         -------------------------------------------------------------------
  2651.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 42
  2652.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  2653.         -------------------------------------------------------------------
  2654.  
  2655.  
  2656.  
  2657.  
  2658.         OS/2 Version 1.x
  2659.  
  2660.              Under OS/2 version 1.x, you can install 4DOS simply by setting
  2661.              the SHELL= line in CONFIG.SYS.  This command determines how
  2662.              4DOS starts when you invoke the DOS Compatibility Box from the
  2663.              OS/2 desktop.
  2664.  
  2665.              You can use the [options] portion of the SHELL command to
  2666.              select a special 4DOS.INI file and to set any other 4DOS
  2667.              command line options you choose.  In essence, you can set up
  2668.              4DOS just as you would if you installed it on a DOS system
  2669.              without OS/2.
  2670.  
  2671.              You can skip the sections below which explain how to configure
  2672.              DOS sessions under OS/2 version 2.x.  If you are using the
  2673.              OS/2 version 1.x Dual Boot capability, you should read the
  2674.              section on Dual Boot and Boot Manager (page 49).
  2675.  
  2676.  
  2677.         OS/2 Version 2.x
  2678.  
  2679.              Under OS/2 version 2.x, you can have multiple objects which
  2680.              start DOS sessions, also called Virtual DOS Machines (VDMs).
  2681.              These may include objects in the Command Prompts window,
  2682.              objects for "migrated applications," objects for DOS and
  2683.              Windows applications, and objects for batch files.
  2684.  
  2685.              Assuming you set up your VDM objects as described here, 4DOS
  2686.              is loaded as a primary shell each time a DOS session starts.
  2687.              4DOS will process 4DOS.INI, execute your 4START file if you
  2688.              have one, and execute AUTOEXEC.BAT.  When the session is
  2689.              closed with the EXIT command, 4DOS will run your 4EXIT file if
  2690.              you have one.  You can start any number of DOS sessions and
  2691.              (within the limits of system resources) have as many running
  2692.              simultaneously as you like.
  2693.  
  2694.              This is fundamentally different from what happens when you
  2695.              boot your computer under DOS or OS/2 1.x.  In these
  2696.              environments there is only one 4DOS primary shell,
  2697.              AUTOEXEC.BAT is only executed once each time you boot, and so
  2698.              on.  OS/2 version 2.x gives you much more flexibility, but
  2699.              that flexibility requires planning to get the most out of
  2700.              4DOS.
  2701.  
  2702.              For example, you can have all your DOS sessions use the same
  2703.              AUTOEXEC.BAT file, or you can have different versions of
  2704.              AUTOEXEC.BAT for different sessions.  The same is true of the
  2705.              other startup and exit files (4DOS.INI, 4START, and 4EXIT).
  2706.  
  2707.  
  2708.         -------------------------------------------------------------------
  2709.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 43
  2710.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  2711.         -------------------------------------------------------------------
  2712.  
  2713.  
  2714.              This section and the sections below discuss how to set up
  2715.              objects for your DOS sessions, and how to arrange your startup
  2716.              and exit files so that 4DOS will do just what you want it to
  2717.              in each DOS session.
  2718.  
  2719.  
  2720.              Settings for DOS Sessions
  2721.  
  2722.              Each VDM object contains its own information about how to
  2723.              start DOS for that session.  In essence, each object has its
  2724.              own CONFIG.SYS file built into it.  The information attached
  2725.              to an object which indicates how to start DOS is called its
  2726.              DOS Settings.
  2727.  
  2728.              You can modify these settings using OS/2's Settings notebook.
  2729.              To do so, click the right mouse button in the object.  When
  2730.              the popup menu appears, click the left mouse button on the
  2731.              small arrow to the right of the Open selection, then again on
  2732.              the Settings selection on the submenu.
  2733.  
  2734.              Once the Settings notebook is open, use the Program page to
  2735.              modify the object's program name, startup directory, and
  2736.              command line parameters.  The Session page lets you set the
  2737.              session type.  Other pages let you adjust other configuration
  2738.              data for the object.
  2739.  
  2740.              To modify the DOS settings, use the button with that legend on
  2741.              the Session page of the notebook.  Clicking on this button
  2742.              opens the DOS settings dialog box.  To modify an individual
  2743.              setting, click on the setting name in the list box at the
  2744.              left, then click on the value window to the right and enter
  2745.              the new value.  Settings with choice values (such as "On" and
  2746.              "Off") will show buttons for the value, rather than a text
  2747.              window.
  2748.  
  2749.              In a new object, each DOS setting starts out with a default
  2750.              value taken from your CONFIG.SYS file.  For settings which
  2751.              have no corresponding command in CONFIG.SYS, OS/2 uses a
  2752.              built-in default value.
  2753.  
  2754.              For example, the DOS_SHELL setting, which specifies the
  2755.              command processor to use for a DOS session, defaults to the
  2756.              value on the SHELL= line in CONFIG.SYS.  Changing the SHELL=
  2757.              line changes the default DOS_SHELL value for all new DOS
  2758.              sessions (as usual, changes to CONFIG.SYS are only effective
  2759.              after you reboot the system).
  2760.  
  2761.              However, the HW_TIMER setting (which tells OS/2 whether to
  2762.              allow the session to manipulate the hardware timer), always
  2763.              defaults to OFF.  The default cannot be changed in CONFIG.SYS.
  2764.  
  2765.  
  2766.         -------------------------------------------------------------------
  2767.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 44
  2768.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  2769.         -------------------------------------------------------------------
  2770.  
  2771.  
  2772.              Modifying a setting whose default is specified in CONFIG.SYS,
  2773.              such as DOS_SHELL, breaks the "link" between that setting and
  2774.              the default in CONFIG.SYS.  After the modification, changes
  2775.              made to the default in CONFIG.SYS will not affect the object
  2776.              at all.
  2777.  
  2778.              For example, to set up 4DOS as your default DOS command
  2779.              processor for OS/2 DOS sessions you might include this line in
  2780.              the OS/2 CONFIG.SYS file:
  2781.  
  2782.                   SHELL= C:\4DOS\4DOS\COM C:\4DOS /P
  2783.  
  2784.              If you then create a new DOS session object, its DOS_SHELL
  2785.              setting will reflect the value from the SHELL= line.  Now
  2786.              suppose you modify the DOS_SHELL setting for that object so
  2787.              that it reads:
  2788.  
  2789.                   C:\4DOS\4DOS.COM C:\4DOS /L /P
  2790.  
  2791.              At this point the "link" between your object and CONFIG.SYS is
  2792.              broken.  If you move 4DOS to a different directory and modify
  2793.              the SHELL= line in CONFIG.SYS, the object's DOS_SHELL setting
  2794.              will not be changed, and the object will no longer work
  2795.              properly.  In order to correct this you will have to manually
  2796.              modify the DOS_SHELL setting for that object.
  2797.  
  2798.              You can return any DOS setting to the current default value at
  2799.              any time.  To do so, open the DOS Settings dialog box,
  2800.              highlight the setting name, and click on the Default button.
  2801.              This replaces the value of the setting with the value OS/2
  2802.              read from CONFIG.SYS when you last booted, or with the value
  2803.              from OS/2's standard defaults.  For settings which have a
  2804.              default in CONFIG.SYS, this re-establishes the link between
  2805.              the object and CONFIG.SYS, and subsequent changes you make in
  2806.              CONFIG.SYS will again be reflected in the setting for that
  2807.              object each time you reboot.
  2808.  
  2809.  
  2810.              Configuring DOS Sessions for 4DOS
  2811.  
  2812.              To create a VDM object that gives you a standard 4DOS prompt,
  2813.              first place an asterisk [*] in the Program Name field (on the
  2814.              Program page in the Settings notebook).  This tells OS/2 to
  2815.              load the DOS command processor and go to a prompt instead of
  2816.              running a specific DOS application.  Then go to the Session
  2817.              page and set the session type to DOS Full Screen or DOS
  2818.              Window.
  2819.  
  2820.              Next, click on the DOS Settings button and set up the DOS
  2821.              settings for the object.  4DOS will run properly with default
  2822.  
  2823.  
  2824.         -------------------------------------------------------------------
  2825.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 45
  2826.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  2827.         -------------------------------------------------------------------
  2828.  
  2829.  
  2830.              DOS settings, but you may want to check that the DOS_SHELL
  2831.              setting is correct, because this setting determines which
  2832.              command processor OS/2 will load when the object is used to
  2833.              start a session.
  2834.  
  2835.              DOS_SHELL is formatted just like the SHELL= line in CONFIG.SYS
  2836.              (see page 11), but without the characters "SHELL=".  The
  2837.              DOS_SHELL setting should always include the COMSPEC path (see
  2838.              page 17 for an explanation of the COMSPEC path).  For example,
  2839.              you might set DOS_SHELL to:
  2840.  
  2841.                   C:\4DOS\4DOS.COM C:\4DOS /P
  2842.  
  2843.              If you've set up CONFIG.SYS for 4DOS as described in Chapter
  2844.              1, any new VDM objects you create will automatically use the
  2845.              correct DOS_SHELL setting for 4DOS.  However, VDM objects
  2846.              which existed before you modified CONFIG.SYS may list
  2847.              COMMAND.COM in the DOS_SHELL setting.  To correct the setting
  2848.              so that 4DOS is used for these objects, modify DOS_SHELL in
  2849.              each object to point to 4DOS, as shown in the example above,
  2850.              or change DOS_SHELL back to the default value with the Default
  2851.              button.
  2852.  
  2853.              You can customize any object with optional 4DOS command line
  2854.              switches, such as @ininame, or //iniline (see page 11 for more
  2855.              details).  These switches can be placed at the end of the
  2856.              DOS_SHELL setting, or in the Parameters field in the Program
  2857.              window.
  2858.  
  2859.              For example, your Program page might have the following
  2860.              settings for a standard 4DOS prompt, using a special .INI file
  2861.              for this session:
  2862.  
  2863.                   Program Name:       *
  2864.                   Parameters:         @C:\4DOS\OS2VDM.INI
  2865.                   Working Directory:  C:\
  2866.  
  2867.              You can run any alias, internal command, DOS application, or
  2868.              batch file directly from a 4DOS VDM object.  To do so, place
  2869.              the command to be executed as the last item in the Parameters
  2870.              field for the object.  4DOS will execute the command and then
  2871.              display a prompt.  4DOS will execute the command after it
  2872.              processes your 4START file (if any) and AUTOEXEC.BAT.
  2873.  
  2874.              If you precede the command name with /C, 4DOS will exit and
  2875.              return to the OS/2 desktop when the command is finished.  This
  2876.              is a "temporary" VDM, described in more detail on page 48.
  2877.              You can also make 4DOS exit when the command is complete by
  2878.              invoking a batch file or alias which ends with the EXIT
  2879.              command.
  2880.  
  2881.  
  2882.         -------------------------------------------------------------------
  2883.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 46
  2884.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  2885.         -------------------------------------------------------------------
  2886.  
  2887.  
  2888.              You can create an object which runs a DOS program by placing
  2889.              the program name (including drive and path) in the object's
  2890.              Program Name field.  When you select the object, OS/2 will
  2891.              automatically start a temporary VDM to run the program.  See
  2892.              page 48 for additional details.
  2893.  
  2894.          ##  Once you have created a 4DOS object on your desktop, you may
  2895.              wish to create a menu item on the desktop menu to run it.  You
  2896.              can do so using OS/2's menu editing facilities.  If you do,
  2897.              when you start 4DOS from the menu OS/2 will pass the name of
  2898.              the desktop directory as a command line argument to 4DOS.
  2899.              This directory name will appear to 4DOS as a COMSPEC path or a
  2900.              command to be executed, and may result in an error message
  2901.              when the session is started from the desktop menu.  To avoid
  2902.              this, add a single % sign in the Parameters field for the
  2903.              object.  The % sign will prevent OS/2 from passing the
  2904.              directory name, but will be treated as a null parameter by
  2905.              4DOS.
  2906.  
  2907.  
  2908.              4DOS.INI
  2909.  
  2910.              Each time you start a DOS session, 4DOS will search for
  2911.              4DOS.INI in the directory where 4DOS.COM is stored, then in
  2912.              the root directory of the boot drive.
  2913.  
  2914.              In most cases, the best strategy is to put 4DOS.INI in the
  2915.              same directory as 4DOS.COM and make sure your COMSPEC setting
  2916.              is correct as described above.  4DOS will use this 4DOS.INI
  2917.              file by default for all DOS sessions.
  2918.  
  2919.              To use a different .INI file for sessions started from a
  2920.              particular object, include an @ininame parameter on the
  2921.              DOS_SHELL setting for that object as described in the previous
  2922.              section.  Be sure to include the full path and name of the
  2923.              file.  To modify specific 4DOS.INI settings for sessions
  2924.              started from an object, use one or more //iniline parameters
  2925.              on the DOS_SHELL setting for the object.  For objects with a
  2926.              [*] in the program name field, the @ininame or //iniline
  2927.              parameters may be placed at the beginning of the Parameters
  2928.              field if you wish, rather than in the DOS_SHELL setting.
  2929.  
  2930.              You can also use the @ininame parameter on your SHELL= line in
  2931.              the OS/2 CONFIG.SYS file to change the default location of
  2932.              4DOS.INI for all DOS sessions run under OS/2.  If you do so,
  2933.              remember that changes made in CONFIG.SYS will only take effect
  2934.              after your next reboot, and will not affect existing objects
  2935.              whose DOS_SHELL setting has been changed from its default
  2936.              value.
  2937.  
  2938.  
  2939.  
  2940.         -------------------------------------------------------------------
  2941.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 47
  2942.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  2943.         -------------------------------------------------------------------
  2944.  
  2945.  
  2946.              AUTOEXEC.BAT, 4START, and 4EXIT
  2947.  
  2948.              Each time you start a DOS session, 4DOS will search for 4START
  2949.              and 4EXIT in the directory where 4DOS.COM is stored, then in
  2950.              the root directory of the OS/2 boot drive.  It will search for
  2951.              AUTOEXEC.BAT in the root directory of the OS/2 boot drive.
  2952.              Therefore, the same 4START, 4EXIT, and AUTOEXEC.BAT files will
  2953.              normally be used for all DOS sessions.  You can override these
  2954.              defaults with the 4StartPath and AutoExecPath directives in
  2955.              4DOS.INI.
  2956.  
  2957.              To select different 4START, 4EXIT, and AUTOEXEC.BAT files for
  2958.              a particular object, place the files for that object in a
  2959.              directory that is not one of the default directories described
  2960.              above.  Then create a new 4DOS.INI file for that object, using
  2961.              the 4StartPath and / or AutoExecPath directives to point to
  2962.              the new directory, or use a //4StartPath or //AutoExecPath
  2963.              directive in the DOS_SHELL setting or parameters field for the
  2964.              object.
  2965.  
  2966.              To disable the default 4START, 4EXIT, or AUTOEXEC.BAT files
  2967.              for a particular object without selecting alternate files, use
  2968.              the techniques described above to tell 4DOS to load these
  2969.              files from a directory where they do not exist.  All three
  2970.              files are optional, so if they do not exist in the directory
  2971.              specified by 4StartPath or AutoExecPath, they will not be
  2972.              executed.
  2973.  
  2974.              Remember that if your 4START and 4EXIT files have the
  2975.              extension .BTM, they may be executed by both 4DOS and 4OS2.
  2976.              If so, you may need to customize them for DOS mode and OS/2
  2977.              mode.  You can use the internal variable %_DOS to separate
  2978.              commands for each operating system.  For example:
  2979.  
  2980.                   iff "%_DOS" == "DOS"
  2981.                      rem Commands for DOS only go here
  2982.                   else
  2983.                      rem Commands for OS/2 only go here
  2984.                   endiff
  2985.  
  2986.  
  2987.         "Temporary" VDMs
  2988.  
  2989.              So far, we have discussed starting a VDM to run 4DOS and get
  2990.              to the DOS prompt.  OS/2 version 2.x also lets you start a
  2991.              temporary VDM, for example to run a DOS application or batch
  2992.              file from a desktop object.
  2993.  
  2994.              In a temporary VDM, 4DOS is still loaded as the primary shell
  2995.              even though it is being invoked to run just a single command
  2996.  
  2997.  
  2998.         -------------------------------------------------------------------
  2999.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 48
  3000.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  3001.         -------------------------------------------------------------------
  3002.  
  3003.  
  3004.              or application.  This primary 4DOS shell is also a "transient"
  3005.              shell that exits (back to OS/2) when its job is done.
  3006.              Temporary VDMs are created automatically by OS/2 if you set up
  3007.              an object with the Program Name set to the name of a DOS
  3008.              application.  You can also start them yourself by using a /C
  3009.              (see page 16) in the Parameters field for a standard 4DOS
  3010.              object.
  3011.  
  3012.              For example, to create a temporary VDM to run your word
  3013.              processor you might set up an object like this:
  3014.  
  3015.                   Program Name:       E:\WORDPROC\WP.EXE
  3016.                   Parameters:         [blank]
  3017.                   Working Directory:  D:\LETTERS
  3018.  
  3019.              You usually won't want a temporary VDM to load all the memory-
  3020.              resident utilities and execute all the commands that you want
  3021.              when you are setting up a DOS prompt.  Most often, you will
  3022.              want to set up a simple VDM, run the command, and exit as
  3023.              quickly as possible.  The 4DOS internal variable %_TRANSIENT
  3024.              makes it easy to do just that.  The beginning of your
  3025.              AUTOEXEC.BAT file could look like this:
  3026.  
  3027.                   iff %_transient == 1 then
  3028.                        call setpath
  3029.                        call aliases
  3030.                        quit
  3031.                   endiff
  3032.  
  3033.              This fragment calls other batch files to set up the path and
  3034.              aliases, but it does not load TSRs.
  3035.  
  3036.  
  3037.         Configuring 4DOS for Dual Boot and Boot Manager
  3038.  
  3039.              When you install OS/2, you are given a choice of making it the
  3040.              only operating system on your computer, or retaining a DOS
  3041.              boot capability as well.
  3042.  
  3043.              If you retain a DOS boot capability, OS/2 offers two different
  3044.              methods for switching between DOS and OS/2:  Dual Boot (OS/2
  3045.              versions 1.x and 2.x) and Boot Manager (OS/2 version 2.x
  3046.              only).  The way you configure 4DOS to work with OS/2 depends
  3047.              partly on whether you retain a DOS boot capability on your
  3048.              computer, and, if so, which method you choose.
  3049.  
  3050.              Dual Boot is invoked with the BOOT command (the program
  3051.              BOOT.COM distributed with OS/2).  If you use Dual Boot, you
  3052.              will have one copy of CONFIG.SYS and AUTOEXEC.BAT available on
  3053.              your boot drive when you boot in DOS mode and another version
  3054.  
  3055.  
  3056.         -------------------------------------------------------------------
  3057.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 49
  3058.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  3059.         -------------------------------------------------------------------
  3060.  
  3061.  
  3062.              available when you boot in OS/2 mode.  BOOT.COM works by
  3063.              swapping the DOS and OS/2 versions of CONFIG.SYS and
  3064.              AUTOEXEC.BAT, as well as other system data, then rebooting the
  3065.              computer.
  3066.  
  3067.              Boot Manager (included with OS/2 version 2.x only) uses a
  3068.              different approach.  It lets you install DOS on one hard drive
  3069.              partition and OS/2 on another partition.  When you boot the
  3070.              computer, Boot Manager displays a menu and lets you pick which
  3071.              operating system to boot.  Each partition will have its own
  3072.              versions of CONFIG.SYS and AUTOEXEC.BAT.
  3073.  
  3074.              The difference between these approaches is the location and
  3075.              availability of files.
  3076.  
  3077.              If you use Dual Boot, the system always boots from the same
  3078.              drive, whether you are booting DOS or OS/2.  The CONFIG.SYS
  3079.              and AUTOEXEC.BAT files are switched back and forth as you
  3080.              switch from one operating system to the other.  The set of
  3081.              files that is in use at any given time is stored in the root
  3082.              directory of the boot drive, and the set not in use is stored
  3083.              in the \OS2\SYSTEM directory.
  3084.  
  3085.              If you use the Boot Manager, the files for DOS reside on one
  3086.              drive (for example, C) and those for OS/2 are on another drive
  3087.              (for example, D).  The files are not moved when you switch
  3088.              operating systems.  In both cases, you can keep the startup
  3089.              files synchronized or independent to meet your own needs.
  3090.  
  3091.  
  3092.              CONFIG.SYS
  3093.  
  3094.              Setting up CONFIG.SYS is very simple, whether you are using
  3095.              Dual Boot or Boot Manager.  Modify both the DOS and OS/2
  3096.              CONFIG.SYS files for 4DOS as described on page 7.  The two
  3097.              files remain separate, and any changes to common items (for
  3098.              example the name of the directory where 4DOS is stored, used
  3099.              in the SHELL= command) must be made in both files.
  3100.  
  3101.  
  3102.              AUTOEXEC.BAT
  3103.  
  3104.              With AUTOEXEC.BAT, you have more flexibility.  Whether you use
  3105.              Dual Boot or Boot Manager, you will have two standard
  3106.              AUTOEXEC.BAT files:  one for starting 4DOS under a DOS boot
  3107.              and one for OS/2 DOS sessions.
  3108.  
  3109.              If you want different commands in AUTOEXEC.BAT for a DOS boot
  3110.              and OS/2 DOS sessions, you can keep the two files separate and
  3111.              distinct.  Just be sure to update both files whenever you make
  3112.  
  3113.  
  3114.         -------------------------------------------------------------------
  3115.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 50
  3116.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  3117.         -------------------------------------------------------------------
  3118.  
  3119.  
  3120.              changes to the commands they have in common.  You can also
  3121.              CALL other batch files from each copy of AUTOEXEC.BAT to
  3122.              handle common commands.
  3123.  
  3124.              You may find that many of the commands in the two AUTOEXEC.BAT
  3125.              files are the same and that it is more convenient to maintain
  3126.              a single file.  The following paragraphs explain how to do so.
  3127.  
  3128.              If you use the Boot Manager, you can put all of your
  3129.              instructions in one file and start it from the other.  For
  3130.              example, if DOS boots from drive C: and OS/2 boots from drive
  3131.              D:, your AUTOEXEC.BAT on drive D: could simply be:
  3132.  
  3133.                   cdd c:\
  3134.                   autoexec.bat
  3135.  
  3136.              On a Dual Boot system the startup files are moved each time
  3137.              you boot, so you cannot start one file from the other as you
  3138.              can with Boot Manager.  If are using Dual Boot and you want to
  3139.              use the same commands in AUTOEXEC for both DOS and OS/2, you
  3140.              must put all of your commands into a third file (for example,
  3141.              C:\SYSTART.BAT), and CALL that file from both the DOS and OS/2
  3142.              AUTOEXEC.BAT files.
  3143.  
  3144.              You can also use the AutoExecPath directive in 4DOS.INI to
  3145.              force 4DOS to look in a particular directory for AUTOEXEC.BAT
  3146.              regardless of whether it is started from an OS/2 DOS session
  3147.              or from a DOS boot, and regardless of the boot drive.
  3148.  
  3149.              If you keep commands for both boot modes in a single
  3150.              AUTOEXEC.BAT file, you can use the internal variable %_DOSVER
  3151.              to separate commands to be executed during a DOS boot from
  3152.              those for an OS/2 DOS session.  %_DOSVER will be 10 or above
  3153.              for OS/2 DOS sessions.  For example:
  3154.  
  3155.                   iff %_DOSVER ge 10.0
  3156.                      rem Commands for OS/2 DOS go here
  3157.                   else
  3158.                      rem Commands for native DOS go here
  3159.                   endiff
  3160.  
  3161.  
  3162.              4DOS.INI, 4START, and 4EXIT
  3163.  
  3164.              Handling 4DOS's startup and exit files is a little different.
  3165.              Unlike CONFIG.SYS and AUTOEXEC.BAT, the other startup files
  3166.              won't be swapped for you when you switch operating systems
  3167.              with Dual Boot, and they won't be automatically stored on
  3168.              separate partitions if you use the Boot Manager.  4DOS
  3169.              normally looks for these files in the directory where 4DOS.COM
  3170.  
  3171.  
  3172.         -------------------------------------------------------------------
  3173.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 51
  3174.                                           CHAPTER 4 / USING 4DOS UNDER OS/2
  3175.         -------------------------------------------------------------------
  3176.  
  3177.  
  3178.              is stored, so the same files will be used for both a DOS boot
  3179.              and OS/2 DOS sessions.
  3180.  
  3181.              To set up one 4DOS.INI file for DOS and another for OS/2 DOS
  3182.              sessions, use the @ininame parameter on the SHELL= line in
  3183.              CONFIG.SYS (see page 11).  For example, you might configure
  3184.              the SHELL= line for DOS to load the default file (4DOS.INI in
  3185.              your 4DOS directory), and use the @ininame parameter on the
  3186.              SHELL= line in the OS/2 CONFIG.SYS file to select a different
  3187.              .INI file for OS/2 DOS sessions.  To do so, use a line like
  3188.              this for DOS:
  3189.  
  3190.                   SHELL=C:\4DOS\4DOS.COM C:\4DOS /P
  3191.  
  3192.              And one like this for OS/2 (enter this on one line):
  3193.  
  3194.                   SHELL=C:\4DOS\4DOS.COM C:\4DOS @C:\4DOS\4DOSOS2.INI /P
  3195.  
  3196.              To select different 4START and 4EXIT files for DOS and for
  3197.              OS/2 DOS sessions, place one set of files in a different
  3198.              directory (not the directory where 4DOS.COM is stored).  Then
  3199.              either set up a different 4DOS.INI file for that boot mode as
  3200.              described above, using 4StartPath to point to the new
  3201.              directory, or use a //4StartPath directive on the SHELL= line
  3202.              in CONFIG.SYS for that boot mode.  For example, this line in
  3203.              an OS/2 CONFIG.SYS file sets 4DOS as the command processor,
  3204.              and tells 4DOS to look for 4START and 4EXIT in the
  3205.              C:\4DOS\OS2START directory (enter this on one line):
  3206.  
  3207.                   SHELL=C:\4DOS\4DOS.COM C:\4DOS
  3208.                   //4STARTPATH=C:\4DOS\OS2START /P
  3209.  
  3210.              You can also keep commands for both boot modes in a single
  3211.              4START or 4EXIT file, and use %_DOSVER to separate the
  3212.              commands to be executed during a DOS boot from those for an
  3213.              OS/2 DOS session.  For a basic example, see page 51.
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.         -------------------------------------------------------------------
  3231.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 52
  3232.                        Appendix A / Solving Software Compatibility Problems
  3233.         -------------------------------------------------------------------
  3234.  
  3235.  
  3236.  
  3237.         Appendix A / Solving Software Compatibility Problems
  3238.  
  3239.  
  3240.         Any DOS program running on your computer can potentially interact
  3241.         with any other program running at the same time.  Of course, most
  3242.         program interactions are ones you want:  your print spooler
  3243.         intercepts printer output and saves it to print later, or your disk
  3244.         cache intercepts disk requests and speeds them up by retrieving
  3245.         data from memory.
  3246.  
  3247.         If you've used the PC for any length of time, however, you'll know
  3248.         that you can also get interactions you don't want.  If you load
  3249.         just the wrong combination of TSRs and device drivers, your system
  3250.         may slow to a crawl.  Perhaps you can't load your favorite Personal
  3251.         Information Manager with Windows running.  And so on.
  3252.  
  3253.         As publishers of a product that replaces part of the operating
  3254.         system, we're very familiar with these issues - not because 4DOS is
  3255.         more likely to cause problems, but because it sometimes gets blamed
  3256.         first when a problem appears.  Our technical support department has
  3257.         developed a set of reliable techniques for finding out what's
  3258.         causing an apparent compatibility problem with 4DOS and other
  3259.         software.
  3260.  
  3261.         We are presenting these techniques here as a series of things to
  3262.         try when there seems to be a compatibility problem.  Some may not
  3263.         make sense for the particular problem you're investigating.  Others
  3264.         may not yield useful results.  But as a group, they'll help you
  3265.         resolve many of the common software interactions that do appear,
  3266.         whether with 4DOS or anything else.  Before you get started, be
  3267.         sure to check APPNOTES.DOC to see if we've already solved the
  3268.         problem you're facing.
  3269.  
  3270.         If you've tried the techniques in this section and haven't found
  3271.         the problem, contact our technical support department (see page 3).
  3272.         We have more tricks up our sleeve, and a very high success rate at
  3273.         resolving compatibility problems.
  3274.  
  3275.         Some of our suggestions help you figure out what's going on, but
  3276.         aren't intended to help you fix it.  For example, when we suggest
  3277.         that you remove all your TSRs to look for the problem, we aren't
  3278.         suggesting that as a permanent solution, but only as a diagnostic
  3279.         test.
  3280.  
  3281.         The first thing to consider is whether the particular combination
  3282.         of software that's not working used to work together.  If so, think
  3283.         carefully about what you have changed and see if reversing the
  3284.         change solves the problem.  If it does, then you can narrow your
  3285.  
  3286.  
  3287.  
  3288.         -------------------------------------------------------------------
  3289.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 53
  3290.                        Appendix A / Solving Software Compatibility Problems
  3291.         -------------------------------------------------------------------
  3292.  
  3293.  
  3294.         search, using the following techniques to find out what it is about
  3295.         that specific change that is causing the problem.
  3296.  
  3297.         Second, make sure that your problem can be reproduced relatively
  3298.         easily, and make sure you know exactly what sequence of commands or
  3299.         other steps reproduces it.  Most interactions are very easy to
  3300.         reproduce, but if you think there's an interaction and it occurs
  3301.         once every 10 days, it's going to be difficult to know when you
  3302.         have fixed it.  Also, the process of carefully documenting how to
  3303.         reproduce a problem often helps you realize what the problem is
  3304.         without further effort.
  3305.  
  3306.         If you have a problem with a specific application hanging or
  3307.         working improperly, and the above techniques don't help, then try
  3308.         reducing your system configuration to the simplest possible level.
  3309.         This is the single most useful tool we know for finding
  3310.         compatibility problems.  To do so, use all of the approaches listed
  3311.         below, and any other similar things you may be able to think of
  3312.         about your particular system after reading our suggestions.
  3313.  
  3314.         When you're modifying 4DOS.INI in an attempt to resolve problems,
  3315.         you may find the INIQuery directive useful.  If you set INIQuery to
  3316.         Yes for a section of 4DOS.INI, then 4DOS will prompt you for each
  3317.         line in that section.  This allows you to test the effects of
  3318.         changing directives in the .INI file without actually modifying the
  3319.         file for each test.
  3320.  
  3321.  
  3322.         Path Length
  3323.  
  3324.              The first thing to do is to check the length of your PATH
  3325.              variable.  4DOS lets you make it longer than the traditional
  3326.              limit of 123 characters.  Some programs can't handle long
  3327.              PATHs and may behave strangely.  If your PATH is over the
  3328.              traditional limit, reduce its size using the PATH or ESET
  3329.              command and see if the application starts working.  If so, use
  3330.              a batch file or alias to set up an alternate path for running
  3331.              that one program, for example:
  3332.  
  3333.                   setlocal
  3334.                   path d:\myprog
  3335.                   d:\myprog\myprog.exe
  3336.                   endlocal
  3337.  
  3338.              The SETLOCAL / ENDLOCAL pair saves and restores the
  3339.              environment; when you're done, the old PATH will be restored
  3340.              automatically.
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.         -------------------------------------------------------------------
  3347.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 54
  3348.                        Appendix A / Solving Software Compatibility Problems
  3349.         -------------------------------------------------------------------
  3350.  
  3351.  
  3352.         Environment Size
  3353.  
  3354.              Next, check how much environment space is in use in your
  3355.              system.  The 4DOS MEMORY command reports the total environment
  3356.              space and the amount free; a simple subtraction tells you how
  3357.              much is in use.  Some programs simply don't work right if
  3358.              there's a lot of information in the environment (these
  3359.              programs don't usually care how big the total environment
  3360.              space is, only how much of it is actually in use).  In most
  3361.              cases, these problems show up when the amount of space in use
  3362.              gets up to around 1K (1024) bytes or so, but they can occur at
  3363.              any point. To test for this, use the following simple batch
  3364.              file:
  3365.  
  3366.                   setlocal
  3367.                   unset var1 var2 var3 ...
  3368.                   [command to run the program in question]
  3369.                   endlocal
  3370.  
  3371.              where VAR1, VAR2, etc. are variables you can remove from the
  3372.              environment to decrease the space in use before running the
  3373.              program.  If reducing the environment space in use makes
  3374.              things work, contact the program's manufacturer and report the
  3375.              problem.  You have found a legitimate bug.  DOS allows an
  3376.              environment of up to 32K bytes, and your program should be
  3377.              able to work with an environment that large.  Until the
  3378.              manufacturer fixes the bug, use the batch file above as a
  3379.              workaround.
  3380.  
  3381.  
  3382.         Testing for Interactions
  3383.  
  3384.              Before testing for software interactions, try booting your
  3385.              system with COMMAND.COM, without changing anything else about
  3386.              your configuration (though you may have to modify AUTOEXEC.BAT
  3387.              if it contains 4DOS-specific commands).  If the problem
  3388.              remains, then it's not related to an interaction with 4DOS.
  3389.              Contact the manufacturer of the software that isn't working
  3390.              properly to determine the cause of the problem.
  3391.  
  3392.              To look for a multi-program interaction, you'll need to remove
  3393.              all the device drivers and TSRs you possibly can and still
  3394.              have enough software present to demonstrate the problem.  For
  3395.              example, you can't look for a network problem if you don't
  3396.              load the network, but you probably can check it without your
  3397.              disk cache running.  If you're running DOS, be sure you have a
  3398.              bootable floppy disk handy (see page 4) before modifying your
  3399.              CONFIG.SYS and AUTOEXEC.BAT files to remove drivers and TSRs.
  3400.  
  3401.  
  3402.  
  3403.  
  3404.         -------------------------------------------------------------------
  3405.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 55
  3406.                        Appendix A / Solving Software Compatibility Problems
  3407.         -------------------------------------------------------------------
  3408.  
  3409.  
  3410.              If you run a partitioning disk driver, you probably can't
  3411.              remove it for diagnostic purposes without temporarily losing
  3412.              access to some or all of your hard disk.  The same may be true
  3413.              of disk compression programs like Stacker, depending on the
  3414.              mode in which they are installed.  Most other device drivers
  3415.              and TSRs can be removed without causing trouble.  Check your
  3416.              system and software manuals if you are unsure of which
  3417.              programs can safely be removed.
  3418.  
  3419.              Once you know what you can take out, don't skimp or guess
  3420.              where the interaction might be.  Take out everything you
  3421.              possibly can from CONFIG.SYS, 4START, and AUTOEXEC.BAT that
  3422.              loads or accesses another program .  In CONFIG.SYS, remove all
  3423.              possible DEVICE and INSTALL statements.  In AUTOEXEC.BAT,
  3424.              remove all the lines you can that load memory-resident
  3425.              programs (and remember that some DOS utilities, like MODE, can
  3426.              be memory-resident).
  3427.  
  3428.              Of course, you should save copies of your configuration files
  3429.              before you delete anything.  Better yet, use the REM command
  3430.              to remove lines temporarily without deleting them.  REM can be
  3431.              used on any line in AUTOEXEC.BAT, in 4START, and in CONFIG.SYS
  3432.              if you are running DOS 4.0 or above.  (In earlier DOS
  3433.              versions, REM will work in CONFIG.SYS but will also generate a
  3434.              harmless "unrecognized command" message during bootup.)  If
  3435.              you want to remove everything in AUTOEXEC.BAT you can rename
  3436.              it to another name (say AUOTEXEC.SAV), and rename it back when
  3437.              you are done testing.
  3438.  
  3439.              Clean out your configuration files all at once, not one line
  3440.              at a time.  If that solves the problem, you're on the right
  3441.              track, and you can put the lines back one at a time until you
  3442.              find the culprit.  If it doesn't solve the problem, you won't
  3443.              waste time removing lines one by one.
  3444.  
  3445.              If the problem isn't there under COMMAND.COM, try fiddling
  3446.              with the program's configuration. If you were loading it high,
  3447.              try loading it low.  If you can change the way it uses memory,
  3448.              try doing so.  If it's a driver that's used by other programs
  3449.              (like your mouse driver) and is quite old, consider obtaining
  3450.              an update from the manufacturer.  All of these techniques will
  3451.              help you narrow down what it is about the program that's
  3452.              causing a problem.  Once you have done that, you may have a
  3453.              simple workaround.  If not, contact our technical support
  3454.              department and we'll try to verify the problem, then resolve
  3455.              it with the manufacturer of the other software.
  3456.  
  3457.              Some problems can be resolved by modifying the order in which
  3458.              you load drivers and TSRs.  If you've found a problem with a
  3459.  
  3460.  
  3461.  
  3462.         -------------------------------------------------------------------
  3463.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 56
  3464.                        Appendix A / Solving Software Compatibility Problems
  3465.         -------------------------------------------------------------------
  3466.  
  3467.  
  3468.              particular driver or TSR, if possible try loading it earlier
  3469.              or later than you were and see if the problem goes away.
  3470.  
  3471.              If you're running OS/2, the process of removing device drivers
  3472.              and TSRs is usually simpler than under DOS.  You probably
  3473.              won't need to modify CONFIG.SYS, but you may need to adjust
  3474.              the DOS Settings for the session in which 4DOS is running (see
  3475.              page 45).  Try changing the amounts of XMS, EMS, and DPMI
  3476.              memory available to the DOS session, removing drivers if any
  3477.              are listed under DOS_DEVICE in your DOS Settings, and removing
  3478.              memory-resident programs loaded in AUTOEXEC.BAT as described
  3479.              above.
  3480.  
  3481.  
  3482.         Memory Allocation Conflicts
  3483.  
  3484.              A memory allocation conflict is very simple.  It occurs when
  3485.              two (or more) programs try to use the same memory, or when a
  3486.              program behaves differently depending on where it is loaded in
  3487.              memory.  Inevitably, at least one of the programs will operate
  3488.              incorrectly, report an error, or hang.  These conflicts can be
  3489.              very hard to diagnose, because it's difficult to determine
  3490.              which programs are actually causing the conflict, and the
  3491.              symptoms may appear to be totally unrelated to the program
  3492.              responsible for the problem.
  3493.  
  3494.              4DOS uses memory in a more complex way than COMMAND.COM.  It
  3495.              can use base, XMS, or EMS memory, and store portions of itself
  3496.              and its data in UMBs (see page 24 for additional details on
  3497.              4DOS memory usage).  COMMAND.COM does not offer any of these
  3498.              capabilities.  This added complexity makes it more likely that
  3499.              you'll encounter memory allocation conflicts with 4DOS.  This
  3500.              isn't because 4DOS is less reliable than other programs, it's
  3501.              because the memory allocation conflict was there waiting to
  3502.              happen, and 4DOS triggered it through its access to additional
  3503.              memory.
  3504.  
  3505.              It's easy to check whether 4DOS's use of memory is a problem.
  3506.              If you configure 4DOS so that it swaps to disk, and disable
  3507.              all use of UMBs, then 4DOS uses only base memory, and (in
  3508.              terms of memory allocation) operates very much like
  3509.              COMMAND.COM.  You can make this change in two simple steps.
  3510.              First, add one line to 4DOS.INI:
  3511.  
  3512.                   Swapping = c:\
  3513.  
  3514.              (change this if you prefer to swap to a different drive, but
  3515.              do not use a RAM disk when you are testing for compatibility
  3516.              problems - the RAM disk itself could be part of the problem).
  3517.              Second, remove any lines in 4DOS.INI which allocate UMBs
  3518.  
  3519.  
  3520.         -------------------------------------------------------------------
  3521.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 57
  3522.                        Appendix A / Solving Software Compatibility Problems
  3523.         -------------------------------------------------------------------
  3524.  
  3525.  
  3526.              (UMBLoad, UMBEnvironment, UMBAlias, and UMBHistory), or place
  3527.              a semicolon at the start of such lines to temporarily turn
  3528.              them into comments.
  3529.  
  3530.              If these steps solve the problem, you've found a memory
  3531.              allocation conflict.  The next thing to do is remove all the
  3532.              drivers and TSRs you can to see if you can determine where the
  3533.              conflict is.  For specific techniques, see page 55.  If you
  3534.              can't come up with an acceptable solution using these
  3535.              techniques, contact JP Software for technical assistance.
  3536.  
  3537.  
  3538.              Memory Allocation and Microsoft Windows
  3539.  
  3540.              If you use Microsoft Windows, there are some specific memory
  3541.              allocation issues you need to consider.  When you run Windows
  3542.              in 386 Enhanced mode, the Windows memory manager "takes over"
  3543.              from the underlying DOS-based memory manager.  If the two
  3544.              programs don't see memory in quite the same way, the conflict
  3545.              can produce some very strange behavior.  For example, the same
  3546.              memory can be allocated twice, or Windows can put portions of
  3547.              itself in areas that were being used by 4DOS or your device
  3548.              drivers and TSRs.  These problems typically apply to upper
  3549.              memory, and not to EMS or XMS memory.  Any of them can cause
  3550.              substantial difficulties in Windows DOS sessions.
  3551.  
  3552.              To avoid such problems you need to systematically verify that
  3553.              Windows and your memory manager are using the same information
  3554.              about upper memory.  You can do so with this approach:
  3555.  
  3556.                   * First, gather a list of all the areas of upper memory
  3557.                     used by your hardware.  This may require consulting
  3558.                     your hardware manuals.  Look for an explanation of the
  3559.                     range of addresses used by each board, as a pair of 4-
  3560.                     digit hexadecimal numbers, for example D400-D7FF.
  3561.                     (Sometimes the addresses have a trailing zero, for
  3562.                     example D4000-D7FF0.  In this case use only the first
  3563.                     4 digits.)  Some boards use no upper memory space at
  3564.                     all.  Boards which may occupy space in upper memory
  3565.                     include network interface cards, SCSI boards, sound
  3566.                     cards, and scanner boards.  Some hard disk controllers
  3567.                     and video boards also use upper memory space,
  3568.                     including "Super VGA" and other high-resolution video
  3569.                     boards.  Video boards may use different areas of upper
  3570.                     memory depending on your display mode.  However, you
  3571.                     don't usually need to consider the standard areas used
  3572.                     by basic VGA boards.
  3573.  
  3574.                   * Next, make sure you have excluded all the areas of
  3575.                     upper memory from management by your memory manager.
  3576.  
  3577.  
  3578.         -------------------------------------------------------------------
  3579.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 58
  3580.                        Appendix A / Solving Software Compatibility Problems
  3581.         -------------------------------------------------------------------
  3582.  
  3583.  
  3584.                     The basic approach is to include a switch when you
  3585.                     start up the memory manager, for example /X=D400-D7FF
  3586.                     to exclude the range D400-D7FF.  See your memory
  3587.                     manager documentation for the exact method.
  3588.  
  3589.                   * Finally, locate the SYSTEM.INI file in your Windows
  3590.                     directory.  Find the section of this file beginning
  3591.                     [386Enh] and add an EMMExclude line to it for each
  3592.                     range to be excluded, for example:
  3593.  
  3594.                        EMMExclude=D400-D7FF
  3595.  
  3596.                     The list in SYSTEM.INI should exactly match the
  3597.                     exclude list given to your memory manager.
  3598.  
  3599.              If this technique solves the problem, you're finished.  If
  3600.              not, also check that any network you have installed is
  3601.              properly configured for Windows.  Errors in network
  3602.              configuration under Windows may generate memory allocation
  3603.              conflicts of their own, and can cause unusual behavior in
  3604.              Windows DOS sessions even though the DOS sessions are not
  3605.              specifically accessing the network.
  3606.  
  3607.  
  3608.         Advanced Configuration Options
  3609.  
  3610.              If none of the other techniques in this Appendix proves
  3611.              useful, some of the advanced directives in 4DOS.INI may help
  3612.              solve very rare configuration problems.  However, unless you
  3613.              are an experienced DOS user and understand the side effects of
  3614.              each directive, they should be used only as diagnostic tools
  3615.              and not as a workaround or fix.  Any of the following can be
  3616.              tried for the conditions indicated:
  3617.  
  3618.                   FineSwap = Yes:  If you are using disk swapping and your
  3619.                   system hangs when exiting an application.
  3620.  
  3621.                   Inherit = No:  If you have unexplained problems in
  3622.                   starting secondary shells.
  3623.  
  3624.                   LineInput = Yes (or SETDOS /L1):  If you have memory-
  3625.                   resident programs which do not recognize that you are at
  3626.                   the prompt.
  3627.  
  3628.                   Reduce = No:  If you have unexplained problems in
  3629.                   starting secondary shells.
  3630.  
  3631.                   ReserveTPA = No:  For unusual memory allocation problems.
  3632.  
  3633.  
  3634.  
  3635.  
  3636.         -------------------------------------------------------------------
  3637.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 59
  3638.                        Appendix A / Solving Software Compatibility Problems
  3639.         -------------------------------------------------------------------
  3640.  
  3641.  
  3642.                   SwapReopen = Yes:  If an application or network generates
  3643.                   reproducible errors related to the 4DOS swap file (for
  3644.                   example "Swap file seek failed" or similar errors)
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.         -------------------------------------------------------------------
  3695.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 60
  3696.                                          APPENDIX B / TECHNICAL INFORMATION
  3697.         -------------------------------------------------------------------
  3698.  
  3699.  
  3700.  
  3701.         APPENDIX B / TECHNICAL INFORMATION
  3702.  
  3703.  
  3704.         This appendix provides technical information for programmers who
  3705.         wish to build interfaces to 4DOS.  It covers detecting 4DOS,
  3706.         placing keystrokes in the Keystack, writing installable commands,
  3707.         using the DESCRIPT.ION file, and using the interrupt 2E "back door"
  3708.         entry into 4DOS to execute commands.
  3709.  
  3710.  
  3711.         Detecting 4DOS
  3712.  
  3713.  
  3714.              Detecting 4DOS From a Batch File
  3715.  
  3716.              From a batch file, you can determine if 4DOS is loaded by
  3717.              testing for the variable function @EVAL, with a test like
  3718.              this:
  3719.  
  3720.                   if "%@eval[2+2]" == "4" echo 4DOS is loaded!
  3721.  
  3722.              This test can not succeed in COMMAND.COM and is therefore a
  3723.              reliable way to detect 4DOS.  Other variable functions could
  3724.              be used for the same purpose.
  3725.  
  3726.  
  3727.              Detecting 4DOS From a Program
  3728.  
  3729.              Any program can test for the presence of 4DOS by making a
  3730.              simple INT 2Fh call.  Be sure to check the INT 2Fh vector
  3731.              first as it may be 0 under some versions of DOS if no program
  3732.              has hooked the interrupt.  To detect 4DOS, call INT 2Fh with:
  3733.  
  3734.                   AX     D44Dh
  3735.                   BX     0
  3736.  
  3737.              If 4DOS is not loaded, AX will be returned unchanged.  If 4DOS
  3738.              is loaded, it will return the following (no other registers
  3739.              are modified):
  3740.  
  3741.                   AX     44DDh
  3742.                   BX     Version number (BL = major version, BH = minor
  3743.                          version)
  3744.                   CX     4DOS PSP segment address
  3745.                   DL     4DOS shell number
  3746.  
  3747.              The shell number is incremented each time a new copy of 4DOS
  3748.              is loaded, either in a different multitasker window (for
  3749.              example, under Windows), or via nested shells.  The primary
  3750.  
  3751.  
  3752.         -------------------------------------------------------------------
  3753.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 61
  3754.                                          APPENDIX B / TECHNICAL INFORMATION
  3755.         -------------------------------------------------------------------
  3756.  
  3757.  
  3758.              shell is shell number 0.  In OS/2 DOS sessions, each session's
  3759.              primary shell is shell 0.
  3760.  
  3761.              The response to INT 2F function D44Dh will come from the most
  3762.              recently loaded 4DOS shell.  For example, if your program is
  3763.              run from a secondary shell the response will come from that
  3764.              secondary shell, and will reflect its shell number and PSP
  3765.              address.
  3766.  
  3767.              This function tells you if 4DOS is loaded in memory, but not
  3768.              whether it is the parent process of your program.  You can
  3769.              determine if 4DOS is the parent process by comparing the PSP
  3770.              value returned in CX to the PSP chain pointer at offset 16h in
  3771.              your program's PSP.
  3772.  
  3773.  
  3774.              Detecting the 4DOS Prompt
  3775.  
  3776.              4DOS generates INT 2Fh calls before and after the prompt is
  3777.              displayed to allow TSRs to detect that 4DOS is at the prompt.
  3778.              The calls are:
  3779.  
  3780.                   AX     D44Eh
  3781.                   BX     0 if 4DOS is about to display the prompt; 1 if
  3782.                          4DOS has displayed the prompt and is about to
  3783.                          accept keyboard input; or 2 if keyboard input is
  3784.                          complete and 4DOS is about to begin processing
  3785.                          the line.
  3786.  
  3787.              Any routine intercepting these calls should preserve the SI,
  3788.              DI, BP, SP, DS, ES, and SS registers.
  3789.  
  3790.  
  3791.         Placing Keystrokes Into the Keystack
  3792.  
  3793.              You can put keystrokes into the 4DOS Keystack with an INT 2Fh
  3794.              call.  First, you must make a call to check whether KSTACK.COM
  3795.              is loaded:
  3796.  
  3797.                   AX     D44Fh
  3798.                   BX     0
  3799.  
  3800.              If KSTACK.COM is not loaded, this call will return AX
  3801.              unchanged.  If it is loaded, AX will be returned as 44DDh;
  3802.              other registers will be unchanged.  Once you have determined
  3803.              that KSTACK.COM is loaded, you can send keystrokes with this
  3804.              call:
  3805.  
  3806.                   AX     D44Fh
  3807.                   BX     1
  3808.  
  3809.  
  3810.         -------------------------------------------------------------------
  3811.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 62
  3812.                                          APPENDIX B / TECHNICAL INFORMATION
  3813.         -------------------------------------------------------------------
  3814.  
  3815.  
  3816.                   CX     number of words being passed (0 - 255)
  3817.                   DS:DX  address of the keystroke array
  3818.  
  3819.              On return, if the call succeeded then AX will be 0; if it
  3820.              failed, AX will be non-zero.  BX, CX, and DX are destroyed;
  3821.              other registers are preserved.  If the call succeeds,
  3822.              subsequent calls to INT 16h functions 0, 1, 10h, or 11h will
  3823.              receive the stacked keystrokes.
  3824.  
  3825.              The keystroke array passed to KSTACK must be an array of words
  3826.              containing the values to return from INT 16h.  The high byte
  3827.              of each word is a scan code and the low byte is an ASCII code.
  3828.              Many programs accept keystrokes properly with only the ASCII
  3829.              code, but some require the scan code as well.  See Appendix B
  3830.              of your Reference Manual for a list of ASCII and scan codes
  3831.              for most keyboards.  To insert a delay in the keystroke
  3832.              sequence, include a word set to FFFFh followed by a word
  3833.              containing the desired delay in clock ticks.
  3834.  
  3835.  
  3836.         Writing Installable Commands
  3837.  
  3838.              An "installable command" is created with a memory-resident
  3839.              program (TSR) which can receive signals from 4DOS and process
  3840.              commands.  4DOS makes every command available to such TSRs
  3841.              before it is executed; if any TSR chooses to execute the
  3842.              command, 4DOS will do no further processing.  Otherwise, 4DOS
  3843.              processes the command normally.
  3844.  
  3845.              The 4DOS "Installable Command" interface is compatible with an
  3846.              undocumented interface present in COMMAND.COM for MS-DOS and
  3847.              PC-DOS 3.3 and above.  This interface is documented more
  3848.              thoroughly in the excellent reference text Undocumented DOS by
  3849.              Schulman et. al., published by Addison Wesley.
  3850.  
  3851.              4DOS looks for an installable command after alias and variable
  3852.              expansion and redirection, and after checking to see if the
  3853.              command is a drive change, but before checking for an internal
  3854.              or external command.
  3855.  
  3856.              4DOS first makes an INT 2Fh call to determine whether any TSR
  3857.              loaded will respond to the command, with:
  3858.  
  3859.                   AX     AE00h
  3860.                   BX     offset of command line buffer:
  3861.                             first byte = maximum length of command line
  3862.                             second byte = actual length of command line,
  3863.                               not including trailing CR
  3864.                             remainder = command line, with a trailing CR
  3865.                   CH     FFh
  3866.  
  3867.  
  3868.         -------------------------------------------------------------------
  3869.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 63
  3870.                                          APPENDIX B / TECHNICAL INFORMATION
  3871.         -------------------------------------------------------------------
  3872.  
  3873.  
  3874.                   CL     length of command line, not including the command
  3875.                          name
  3876.                   DX     FFFFh
  3877.                   SI     offset of command name buffer:
  3878.                             first byte = length of command name
  3879.                             remainder = command name, shifted to upper case
  3880.                               and padded with blanks to 11 characters
  3881.                   DS     segment for command line and command name buffers
  3882.  
  3883.              If the TSR does not recognize the command as its own, it must
  3884.              pass the INT 2Fh along with registers unchanged.  If it does
  3885.              recognize the command, it must return 0FFh in AL.  The command
  3886.              should not be executed at this point.  4DOS will then make
  3887.              another call (buffer formats are the same as above):
  3888.  
  3889.                   AX     AE01h
  3890.                   BX     offset of command line buffer
  3891.                   CH     0
  3892.                   CL     length of command name
  3893.                   DX     FFFFh
  3894.                   SI     offset of command name buffer
  3895.                   DS     segment for command line and command name buffers
  3896.  
  3897.              If the TSR executes the command line, it must set the command
  3898.              name length at DS:[SI] to 0.  If the command name length is
  3899.              not set to 0, 4DOS will attempt to execute the command as an
  3900.              internal or external command.  This allows the TSR to return a
  3901.              modified command line to 4DOS by modifying the command line
  3902.              buffer at DS:BX, and leaving the command name length byte at
  3903.              DS:[SI] set to a non-zero value.  If the command is executed,
  3904.              the TSR should return the result of the command (zero for
  3905.              normal return or non-zero for an error) in AL.
  3906.  
  3907.  
  3908.         Using DESCRIPT.ION
  3909.  
  3910.              4DOS uses the file DESCRIPT.ION to store file descriptions.
  3911.              This file is created as a hidden file in each subdirectory
  3912.              which has descriptions, and deleted when all descriptions are
  3913.              removed or when all files with descriptions are deleted.  If
  3914.              you remove the hidden attribute from the file, 4DOS will not
  3915.              hide it again.
  3916.  
  3917.              Your programs can access DESCRIPT.ION to create, retrieve, or
  3918.              modify file descriptions, and to store other information.
  3919.              DESCRIPT.ION has one line per file, and is unsorted.  Each
  3920.              line is in the following format:
  3921.  
  3922.                   filename.ext Description[*<ID>Other program info]...<CR>
  3923.  
  3924.  
  3925.  
  3926.         -------------------------------------------------------------------
  3927.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 64
  3928.                                          APPENDIX B / TECHNICAL INFORMATION
  3929.         -------------------------------------------------------------------
  3930.  
  3931.  
  3932.              There is normally one space between the description and
  3933.              filename but additional spaces may be used in future versions
  3934.              of 4DOS.  The characters after the description allow extension
  3935.              of the description format for use by other programs.  They are
  3936.              as follows:
  3937.  
  3938.                   * is an ASCII Ctrl-D (04), and marks the end of the
  3939.                   description text and the beginning of information for a
  3940.                   program other than 4DOS.  This symbol can appear multiple
  3941.                   times on each line; each occurrence marks the beginning
  3942.                   of information for another program.
  3943.  
  3944.                   <ID> is an identification byte for the program which is
  3945.                   using this area of the particular line.  If you are
  3946.                   writing a program which will store information in
  3947.                   DESCRIPT.ION, test it using an ID byte of your own
  3948.                   choosing.  When you are ready to release the program,
  3949.                   contact JP Software and we will provide you with an ID
  3950.                   byte value that is not in use by others to the best of
  3951.                   our knowledge.
  3952.  
  3953.                   Other program info is any text the program wishes to
  3954.                   store in its area of the line.  The text should relate
  3955.                   specifically to the file named on the line.  It may not
  3956.                   contain the ASCII 04 character, carriage returns, line
  3957.           feeds, or nulls (ASCII 0s).
  3958.  
  3959.              4DOS will copy, delete, or move all the information on a line
  3960.              in DESCRIPT.ION, including  information owned by other
  3961.              programs, when performing the same action on the corresponding
  3962.              file.  4DOS will also change the name if a file is renamed.
  3963.              To support DESCRIPT.ION properly, your program must do the
  3964.              same if it copies, deletes, moves, or renames files.  Take
  3965.              care not to remove information which does not belong to your
  3966.              program, or delete lines which contain information for other
  3967.              programs.  Your program should be able to handle a line
  3968.              terminated by a CR or LF alone, a CR/LF pair, an EOF (ASCII
  3969.              26), or the physical end of the file.  The lines it creates
  3970.              should be terminated with CR / LF.  The line length limit is
  3971.              4096 bytes; exceeding this limit will cause unpredictable
  3972.              results.
  3973.  
  3974.  
  3975.         Interrupt 2E
  3976.  
  3977.              4DOS provides full, documented support for the undocumented
  3978.              COMMAND.COM "back door" entry, INT 2E (hex).  INT 2E allows
  3979.              applications to call the primary copy of the command processor
  3980.              to execute commands, without loading a secondary shell.
  3981.  
  3982.  
  3983.  
  3984.         -------------------------------------------------------------------
  3985.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 65
  3986.                                          APPENDIX B / TECHNICAL INFORMATION
  3987.         -------------------------------------------------------------------
  3988.  
  3989.  
  3990.              INT 2E support is enabled by default.  It can be disabled with
  3991.              the FullINT2E = No directive in 4DOS.INI, in which case 4DOS
  3992.              "hooks" INT 2E, but any calls to it are ignored.  INT 2E
  3993.              support adds about 100 bytes to the resident size of 4DOS, and
  3994.              applies only to the primary shell (it is ignored in secondary
  3995.              shells).
  3996.  
  3997.              To use INT 2E, set DS:SI to the address of a buffer containing
  3998.              the command, then issue an INT 2E.  The buffer format is:
  3999.  
  4000.                   First byte  Length of the command, not including this
  4001.                               byte or the last byte
  4002.                   Text bytes  The command text
  4003.                   Last byte   CR (ASCII 13)
  4004.  
  4005.              You must release enough memory for 4DOS to reload its
  4006.              transient portion, and provide about 80 bytes of available
  4007.              stack space for the INT 2E handler to use.  INT 2E can not be
  4008.              called from a TSR while 4DOS is running (for example, a TSR
  4009.              popped up at the 4DOS prompt or from within LIST or SELECT),
  4010.              but can be called from within any application or from within a
  4011.              TSR while an application (including the 4DOS HELP system) is
  4012.              running.
  4013.  
  4014.              INT 2E can invoke any 4DOS command including an alias, an
  4015.              internal command, an external command, or a batch file.  All
  4016.              changes to 4DOS data (such as aliases, environment variables,
  4017.              and SETDOS settings) which are made by a command executed via
  4018.              INT 2E calls will affect the primary shell, and the
  4019.              environment passed to a program called via INT 2E will be a
  4020.              copy of the primary shell's environment.
  4021.  
  4022.              INT 2E uses the same internal stack as the primary shell.  If
  4023.              a complex command is used in the primary shell to start a
  4024.              program which eventually issues an INT 2E, the additional
  4025.              stack space required by commands executed through INT 2E may
  4026.              (in rare circumstances) cause a stack overflow.  If this
  4027.              occurs, use the StackSize directive in 4DOS.INI to increase
  4028.              4DOS's internal stack space.
  4029.  
  4030.              INT 2E also uses the same batch file "stack" as the primary
  4031.              shell.  This means that if INT 2E is used to execute a batch
  4032.              file, this batch file is considered "nested" within any batch
  4033.              file(s) used in the primary shell to start the program which
  4034.              issued the INT 2E.  This may cause batch nesting errors from
  4035.              within the INT 2E call which would not occur if the same
  4036.              command were executed at the prompt.
  4037.  
  4038.              On return from INT 2E, all registers will be destroyed except
  4039.              SS and SP.  AX will be set as follows:
  4040.  
  4041.  
  4042.         -------------------------------------------------------------------
  4043.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 66
  4044.                                          APPENDIX B / TECHNICAL INFORMATION
  4045.         -------------------------------------------------------------------
  4046.  
  4047.  
  4048.                   FFFFh  An error occurred before processing the command:
  4049.                          not enough memory was available, INT 2E was
  4050.                          called from a TSR, or another error made it
  4051.                          impossible to handle the interrupt.
  4052.  
  4053.                   0      The command was processed without error.
  4054.  
  4055.                   > 0    There was an error in processing the command.  AX
  4056.                          is the error number, equivalent to the %_? value
  4057.                          from an internal command or the %? value from an
  4058.                          external command.  If a batch file is run, the
  4059.                          value will be the error level returned by the
  4060.                          batch file (via QUIT n or CANCEL n) or the last
  4061.                          command within it.  If an alias is run the value
  4062.                          will be the exit code returned by the last
  4063.                          command in the alias.
  4064.  
  4065.  
  4066.  
  4067.  
  4068.  
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.         -------------------------------------------------------------------
  4101.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 67
  4102.                                                                       Index
  4103.         -------------------------------------------------------------------
  4104.  
  4105.  
  4106.         Index                               A
  4107.  
  4108.                                             Alias list, local and global,
  4109.         Most fully capitalized terms          12, 26, 27
  4110.         (e.g., ECHO, SELECT) are            ANSI driver, 29
  4111.         command names unless otherwise          in CONFIG.SYS, 30
  4112.         noted.                              APPEND command, 32
  4113.                                             APPNOTES.DOC, 2
  4114.                                             AUTOEXEC.BAT, 10, 16
  4115.         Special Characters                      and 4START, 16
  4116.                                                 and installation, 4, 6, 8
  4117.         ## advanced topic mark, 3               and OS/2, 42, 48, 50
  4118.         ! warning mark, 3                       and OS/2 Dual Boot and Boot
  4119.                                                   Manager, 50
  4120.         3                                       and startup command, 13
  4121.                                                 disabling, 12
  4122.         386MAX, 28                              running, 13
  4123.                                                 single-step option, 13
  4124.         4                                       starting KSTACK.COM, 8, 16
  4125.  
  4126.         4DOS for Windows NT, 1              B
  4127.         4DOS.INI, 10
  4128.             and OS/2 DOS sessions, 46,      Back & Forth, 15
  4129.               47                            Base memory, see Memory
  4130.             and OS/2 Dual Boot and Boot     Batch files, startup, 13, 16,
  4131.               Manager, 51                     36
  4132.             directives, on startup              and Microsoft Windows, 38
  4133.               command line, 11, 15          BIOS, 29
  4134.             location of, 11, 15, 47         Boot Manager, see OS/2
  4135.             prompts during execution,       BOOT.SYS, 14
  4136.               54                            Bootable disk, creating, 4
  4137.             reference information, 2
  4138.             secondary section, and          C
  4139.               multitasking, 35
  4140.         4DOS.PIF, 38                        CD-ROM drives, 31
  4141.         4EXIT, 10, 16                       Colors, in help system, 21, 30
  4142.             and 4OS2, 48                    Command history list, local and
  4143.             and OS/2, 48, 51                  global, 12
  4144.             location of, 48                 COMMAND.COM
  4145.         4HELP, see Help system                  in DOS version 2.x, 14
  4146.         4OS2, 1                                 in Microsoft Windows, 38
  4147.             and 4DOS installation, 5            in multitasker DOS windows,
  4148.         4START, 10, 16                            35
  4149.             and 4OS2, 48                    Commands
  4150.             and multitasking, 36                4DOS startup, 13, 16
  4151.             and OS/2, 48, 51                        and multitasking, 36
  4152.             and startup command, 13                 in OS/2 DOS sessions,
  4153.             location of, 48                           46
  4154.             single-step option, 13              help on, 19
  4155.                                                 programming interface, 6
  4156.  
  4157.  
  4158.         -------------------------------------------------------------------
  4159.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 68
  4160.                                                                       Index
  4161.         -------------------------------------------------------------------
  4162.  
  4163.  
  4164.         Commands (continued)                Configuration, 10
  4165.             reference information, 2            troubleshooting, 59
  4166.         Compatibility, 23                   Coprocessor, see Numeric
  4167.             and disks, 31                     coprocessor
  4168.             and memory, 24                  CPU, 23
  4169.             and the CPU, 23                 Critical errors, 12, 15
  4170.             and video hardware and          Cursor shape, 29
  4171.               software, 29
  4172.             solving problems, 53            D
  4173.             with DOS, 32
  4174.             with Microsoft Windows, 37      DBLSPACE, 31
  4175.             with multitasking software,     DEL, speed of, 31
  4176.               34                            Descriptions, see File
  4177.             with networks, 39                 descriptions
  4178.             with Novell Netware, 40         DESQview, 15, 35
  4179.         Compressed drives, 31               Detecting 4DOS, 61
  4180.             and installation, 5             DIR, speed of, 31
  4181.         COMSPEC                             Directory history list, local
  4182.             environment variable, 17          and global, 12
  4183.                 and disk swapping, 19       Directory scans, and Novell
  4184.                 and DOS FORMAT /S, 32         Netware, 41
  4185.                 and multitaskers, 35        Disk drives, 31
  4186.                 checking, 17                    free space on, on networks,
  4187.                 setting automatically,            40
  4188.                   11, 17                        swapping to, 18
  4189.                 setting manually, 9, 17     Disk reset, 31
  4190.             path, 8, 11, 17                 DISKFREE variable function~@~,
  4191.                 and OS/2 DOS sessions,        on networks, 40
  4192.                   11, 46, 47                Diskless workstations, 39
  4193.         CONFIG.SYS, 10                      DISKTOTAL variable function~@~,
  4194.             4DOS commands in, 11              on networks, 40
  4195.             and ANSI driver, 30             DISKUSED variable function~@~,
  4196.             and DOS bug, 14                   on networks, 40
  4197.             and installation, 4, 6, 7       DOS, see also MS-DOS / PC-DOS;
  4198.             in OS/2, 42                       Novell DOS
  4199.                 Dual Boot and Boot              memory, see Memory
  4200.                   Manager, 50                   shell, 1
  4201.                 location of, 50                 version 2.x, 14
  4202.             multiple configuration              versions of, 1
  4203.               utilities, 6, 32              DOS sessions, see OS/2 DOS
  4204.             SET commands in, 32               sessions
  4205.             SHELL=, 11                      DOS version 2.x, 14
  4206.                 and installation, 7         DOS=UMB, in CONFIG.SYS, 28
  4207.                 and multiple                DOS_SHELL, see OS/2 DOS
  4208.                   configuration               sessions
  4209.                   utilities, 14             DR DOS, see Novell DOS
  4210.                 in DOS version 2.x, 15      DRAWBOX, 29
  4211.                 in OS/2 1.x, 43             DRAWHLINE, 29
  4212.                 in OS/2 2.x, 44, 47, 52     DRAWVLINE, 29
  4213.                 length of, 14               Drive, see Disk drives
  4214.  
  4215.  
  4216.         -------------------------------------------------------------------
  4217.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 69
  4218.                                                                       Index
  4219.         -------------------------------------------------------------------
  4220.  
  4221.  
  4222.         Dual Boot, see OS/2                 I
  4223.  
  4224.         E                                   INI file~.~, see 4DOS.INI
  4225.                                             Installable commands, 63
  4226.         EGA, 29, 30                         Installation, 4
  4227.         EMS, see Memory                         and DOS 2.x, 4
  4228.         Environment                             and OS/2 Dual Boot and Boot
  4229.             loading in UMBs, 27                   Manager, 5
  4230.             memory space for, 12, 15            automated, 6
  4231.             size of, and compatibility          directory for, 4
  4232.               problems, 55                      manual, 7
  4233.         Expanded memory, see Memory             of downloaded updates, 4, 7
  4234.         Extended memory, see Memory             on diskettes, 7
  4235.                                                 preparations
  4236.         F                                           under DOS, 4
  4237.                                                     under OS/2, 5
  4238.         File descriptions                       reversing, 8
  4239.             and disk performance, 31            stopping, 7
  4240.             programming for, 64             INT 2E, 65
  4241.         File names, on networks, 39         INT 2F, 61
  4242.         File passwords, in Novell DOS,
  4243.           33                                K
  4244.         Floppy disks, 31
  4245.         FORMAT /S command, 32               KEYSTACK
  4246.         Free memory, see Memory                 and multitasking, 37
  4247.         FREE, on networks, 40                   programming interface, 62
  4248.                                             KSTACK.COM, 8, 16
  4249.         G                                       and multitasking, 37
  4250.  
  4251.         Guided tour, 1, 6, 7                L
  4252.  
  4253.         H                                   LH, 27
  4254.                                             LIST, 29
  4255.         Hard drives, 31                     LOADHIGH, 27
  4256.         Hardware compatibility, see         Local and global aliases and
  4257.           Compatibility                       histories, 12
  4258.         Help system, 2, 19                  Local and global aliases and
  4259.             /? option, 20                     history, 26, 27
  4260.             and monochrome monitor, 30
  4261.             colors, 21                      M
  4262.             configuring, 21
  4263.             keystrokes, 20                  Master environment, see
  4264.             location of files, 22             Environment
  4265.             options, 22, 30                 Memory, 24, 26
  4266.         HELPCFG, see Help system                allocation conflicts, 57
  4267.         History list, local and global,             and networks, 59
  4268.           26, 27                                    and Windows, 58
  4269.         HMA, see Memory                         base, 24
  4270.                                                 checking status, 26
  4271.  
  4272.  
  4273.  
  4274.         -------------------------------------------------------------------
  4275.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 70
  4276.                                                                       Index
  4277.         -------------------------------------------------------------------
  4278.  
  4279.  
  4280.         Memory (continued)                  N
  4281.             expanded (EMS), 24, 25
  4282.                 hardware, 28                Networks, 39
  4283.                 swapping to, 18, 27             disk access problems on, 31
  4284.             extended, 25                        disk space calculations on,
  4285.                 4DOS's use of, 26                 40
  4286.             extended (XMS), 25                  disk swapping on, 40
  4287.                 4DOS's use of, 26               diskless workstations on,
  4288.                 swapping to, 18                   39
  4289.             high memory area (HMA), 25          file and directory names
  4290.             problems with, 27                     on, 39
  4291.             upper, 24                       Novell DOS, 11, 25, 32, 33
  4292.             upper memory blocks (UMBs),         and LOADHIGH, 33
  4293.               25                                memory management, 27
  4294.                 4DOS's use of, 27               passwords, 33
  4295.                 and Windows, 58             Novell Netware, 40
  4296.                 regions, 28                     diskless workstations on,
  4297.                 system requirements               41
  4298.                   for, 28                   Numeric coprocessor, 24
  4299.             used by 4DOS, 18, 26
  4300.         Memory resident programs, see       O
  4301.           TSRs
  4302.         Menus, in CONFIG.SYS, 32            Options, see Startup Options
  4303.         Microsoft Windows, 36, 37           OS/2, 42
  4304.             and batch files, 38                 4OS2 product, 1
  4305.             and compatibility, 58               and 4EXIT, 48
  4306.             and secondary shells, 15            and 4START, 48
  4307.         Monochrome monitor, and help            and AUTOEXEC.BAT, 42, 48
  4308.           system, 22, 30                        and COMSPEC path, 11, 46,
  4309.         Mouse, in help system, 22                 47
  4310.         MS-DOS / PC-DOS, 32                     CONFIG.SYS file, 11, 42
  4311.             APPEND command, 32                  Desktop menu, 47
  4312.             bug in CONFIG.SYS                   DOS sessions, 43
  4313.               processing, 14                        and .INI file, 47
  4314.             FORMAT /S command, 32                   and 4DOS, 45
  4315.             memory management, 25, 27,              DOS_SHELL setting, 44,
  4316.               28                                      46, 47
  4317.             version 2.x, 4                          settings for, 44
  4318.             version 6.x, 13, 14                     startup commands for,
  4319.         Multiple configuration                        46
  4320.           utilities, 6, 14, 32                  Dual Boot and Boot Manager,
  4321.         Multitasking software, 34                 42, 49
  4322.             4DOS windows in, 35                     and 4DOS installation,
  4323.             and COMSPEC, 35                           5
  4324.             and disk swapping, 37                   and 4DOS.INI, 51
  4325.             and KEYSTACK, 37                        and 4EXIT, 51
  4326.             Microsoft Windows, 37                   and 4START, 51
  4327.                                                     and AUTOEXEC.BAT, 50
  4328.                                                     and CONFIG.SYS, 50
  4329.                                                     file locations, 50
  4330.  
  4331.  
  4332.         -------------------------------------------------------------------
  4333.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 71
  4334.                                                                       Index
  4335.         -------------------------------------------------------------------
  4336.  
  4337.  
  4338.         OS/2 (continued)                    Shell, secondary (continued)
  4339.             installing 4DOS for, 5                  swap size, 18
  4340.             temporary VDMs, 46, 48                  to run a single
  4341.             version 1.x, 43                           command, 16
  4342.             version 2.x, 43                 Software compatibility, see
  4343.                                               Compatibility
  4344.         P                                   Software interactions, 55
  4345.                                             Stacker, 31
  4346.         Passwords, in Novell DOS, 33        Startup options
  4347.         PATH, length of, 54                     //iniline, 11, 15, 36, 47
  4348.         Primary shell, see Shell                /C, 16, 46
  4349.         Programming, for 4DOS, see              /D, 12
  4350.           Technical Information                 /E, 12, 15
  4351.                                                 /F, 12, 15
  4352.         Q                                       /K, 13, 16
  4353.                                                 /L, /LA, /LD, and /LH, 12,
  4354.         QEMM, 28                                  16
  4355.         Quick help, 20                          /P, 13
  4356.                                                 /Y, 13
  4357.         R                                       @inifile, 11, 15, 35, 47
  4358.                                                 commands in, 13, 16
  4359.         RAM, see Memory                         primary shell, 11
  4360.         RAM disk, 26                            secondary shell, 15
  4361.             swapping to, 18                 SuperStor, 31
  4362.         README.1ST file, 6                  Support, 3
  4363.         Reference information, 2            Swapping
  4364.         Reference manual, 2                     and compatibility, 27
  4365.         Resident portion (of 4DOS), 18,         and multitasking software,
  4366.           26                                      37
  4367.             loading in UMBs, 27                 file names used by, 18, 37
  4368.                                                 on networks, 40
  4369.         S                                       types of, 18
  4370.  
  4371.         Screen, 29                          T
  4372.             size, 29
  4373.         SCRPUT, 29                          Task switching software, see
  4374.         Secondary shell, see Shell            Multitasking software
  4375.         SELECT, 29                          Technical information, 61
  4376.         SET, in CONFIG.SYS, 32                  DESCRIPT.ION, 64
  4377.         Shell                                   detecting 4DOS, 61
  4378.             DOS shell, 1                        installable commands, 63
  4379.             primary                             INT 2E, 65
  4380.                 and multitasking, 35,           KEYSTACK, 62
  4381.                   37                        Technical support, 3
  4382.                 in OS/2, 48                 Transient portion (of 4DOS),
  4383.                 startup options, 11           18, 26
  4384.                 swap size, 18               TSRs, 23
  4385.             secondary                           and compatibility, 55
  4386.                 and multitasking, 35            and multitasker startup
  4387.                 startup options, 15               files, 36
  4388.  
  4389.  
  4390.         -------------------------------------------------------------------
  4391.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 72
  4392.                                                                       Index
  4393.         -------------------------------------------------------------------
  4394.  
  4395.  
  4396.         TSRs (continued)
  4397.             and OS/2 DOS sessions, 49
  4398.             loading order, 56
  4399.  
  4400.         U
  4401.  
  4402.         UltraVision, 30
  4403.         UMBs, see Memory
  4404.         Uninstalling 4DOS, 8
  4405.  
  4406.         V
  4407.  
  4408.         VDM, see OS/2
  4409.         VGA, 29, 30
  4410.         Video hardware, 29
  4411.         VSCRPUT, 29
  4412.  
  4413.         W
  4414.  
  4415.         Wildcards, and DEL speed, 31
  4416.         Windows, see Microsoft Windows
  4417.         Windows NT, 4DOS/NT product, 1
  4418.  
  4419.         X
  4420.  
  4421.         XMS, see Memory
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.         -------------------------------------------------------------------
  4449.         Copr. 1994 JP Software Inc.   4DOS Intro. & Installation Guide / 73
  4450.